---
title: "Get links to connect social accounts"
method: GET
path: "/v1/social/connect"
tags: ["Profiles"]
---

# Get links to connect social accounts

`GET /v1/social/connect`

## Request

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

Start here. Returns your connected profiles — each with its `label` ("YouTube 2": the network and its number, stable while it stays connected) — and ready-to-use authorization links for every platform: one `page` link with a platform picker and one direct link per platform. Opening a link again connects ANOTHER account of that network (up to `accounts.max` accounts in all). Send a link to the account owner (no APIhub login needed); after they approve, the profile appears in `GET /v1/social/profiles` and can be used in `profiles` when publishing — by id or by label. The plan is priced per connected account: `accounts` says what you pay now and what one more account costs now (the difference for the days left of the period, charged once when it is connected) and from the next renewal. Links are signed and valid for 7 days. Bluesky and Telegram connect with credentials via `POST /v1/social/connect`.

**Billing:** Request · **Rate limit:** 60/min

## Headers

- `Idempotency-Key` string
- `X-Tag` string

## Response `200`

Completed

- object
  - `id` string: Execution id — stable across internal retries; use it with GET /v1/executions/{id}
  - `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
  - `operation` string
  - `tag` string, nullable: Your X-Tag, if sent
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `output` object: Operation result (see each operation). While a Studio render is processing: `stage` (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), `phase` (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), `progress` (a percent, 0–100) and `progress_fraction` (0–1), `eta_seconds` (seconds left, never below 0) and `estimate_seconds`
    - `connect` object
      - `page` string: One link with a picker of all platforms
      - `links` object: Direct link per platform
      - `expires_at` string, date-time
    - `accounts` object: The plan's price at your number of clients (a client = a brand with connected accounts)
      - `max` integer: The most accounts one customer may connect
      - `count` integer
      - `clients` integer
      - `next_account` object
        - `allowed` boolean
        - `monthly_credits` number: One period with one more billable client
        - `charge_now_credits` number: Always 0: a new client's first month is free, and a client paid now is settled once connected
      - `monthly_credits` number: One period at the current count
      - `per_account_credits` number, nullable: The price per client a month at this count
    - `connected` object[]
      - `id` string
      - `name` string, nullable
      - `label` string: "YouTube 2" — usable in `profiles` when publishing
      - `number` integer: The account's number within its network
      - `status` string, nullable
      - `platform` string
      - `username` string, nullable
    - `next_step` string
    - `workspace_id` string
    - `credential_platforms` object
  - `error` string, nullable
  - `usage` object
    - `credits_charged` number, nullable
    - `credits_reserved` number
    - `estimated_credits` number
    - `cost_source` 'provider_reported' | 'calculated' | 'estimated' | 'null', nullable
    - `provider_usage` object, nullable: Normalised consumption, e.g. { VIDEO_SECOND: 22.4 }
  - `balance` object
    - `available` number
    - `reserved` number

## Other responses

- `400`: Invalid input
- `402`: Insufficient credits / project budget
- `404`: Resource not found (or not yours)
- `429`: Rate limited
- `503`: Service temporarily paused

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)