Skip to main content
POST
/
accounts
/
connect
Connect a social account
curl --request POST \
  --url https://api.social-api.ai/v1/accounts/connect \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "brand_id": "b_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "metadata": {},
  "platform": "instagram"
}
'
{
  "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "display_name": "Acme Corp",
  "platform": "instagram",
  "username": "acmecorp"
}

Authorizations

​
Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Body

application/json

Platform and metadata

​
brand_id
string

BrandID optionally specifies which brand to attach the account to. If omitted, a new brand is auto-created.

Example:

"b_01HZ9X3Q4R5M6N7P8V2K0W1J"

​
metadata
object

Metadata contains platform-specific connection data (e.g. redirect_uri for OAuth2 platforms).

​
platform
string

Platform identifies the social platform to connect (e.g. instagram, facebook, google, threads, tiktok, linkedin).

Example:

"instagram"

Response

Account connected (direct auth)

​
account_id
string
Example:

"acc_01HZ9X3Q4R5M6N7P8V2K0W1J"

​
display_name
string
Example:

"Acme Corp"

​
platform
string
Example:

"instagram"

​
username
string
Example:

"acmecorp"