ConnectionStartRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/getsocialclaw-com/json-schema/getsocialclaw-com-connection-start-request-schema.json",
  "title": "ConnectionStartRequest",
  "description": "Request to start an OAuth or manual connection. Telegram and Discord use manual credentials; other providers return an OAuth URL.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/getsocialclaw-com-openapi.json#/components/schemas/ConnectionStartRequest",
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "x",
        "threads",
        "meta",
        "facebook",
        "instagram_business",
        "instagram",
        "snapchat",
        "tiktok",
        "linkedin",
        "linkedin_page",
        "pinterest",
        "youtube",
        "reddit",
        "discord",
        "telegram",
        "wordpress"
      ],
      "description": "Provider to connect."
    },
    "botToken": {
      "type": [
        "string",
        "null"
      ],
      "description": "Telegram bot token. Also accepted as bot_token."
    },
    "chatId": {
      "type": [
        "string",
        "null"
      ],
      "description": "Telegram chat id. Also accepted as chat_id."
    },
    "webhookUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "Discord webhook URL. Also accepted as webhook_url."
    },
    "client": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional client hint, for example ios."
    },
    "callbackScheme": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional mobile callback scheme. Also accepted as callback_scheme."
    }
  },
  "required": [
    "provider"
  ]
}