Profiles

Connect a social profile

Start connecting a social account to your workspace. OAuth platforms return a url to redirect your user to; Bluesky (app password) and Telegram (bot token) connect synchronously. Generates a URL to connect a new social media profile to a profile group via OAuth. Bluesky uses an app-password flow and Telegram uses a bring-your-own-bot flow; both authenticate synchronously and create the profile in one call.

Billing: Request · Rate limit: 30/min

post/v1/social/connect

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/social/connect
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'youtube' | 'twitter' | 'threads' | 'pinterest' | 'bluesky' | 'telegram' required

Platform to connect.

bot_tokenstring

Telegram bot token from @BotFather. Required for telegram.

identifierstring

Bluesky handle (e.g. yourname.bsky.social). Required for bluesky. The .bsky.social suffix is added automatically if missing; custom domains are accepted as-is.

app_passwordstring

Bluesky app password, not the account password. Required for bluesky. Generate at https://bsky.app/settings/app-passwords.

redirect_urlstring uri

Optional. Where to send the user after authorizing. The result is appended as query params: connected=true, or failure=true&error_code=… (e.g. account_is_already_connected). Without it the user sees our confirmation page.

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.