Select a Google Business Profile or Facebook Pages to connect

Promotes a pending connection into a connected account. For Google, pass platform_account_id to choose exactly one candidate Profile. For Facebook, pass page_ids with the subset of candidate Pages to assign to the brand. First selection wins; the pending connection is then consumed.

POST /accounts/pending/{connection_id}/select

Select a Google Business Profile or Facebook Pages to connect

cURL

curl --request POST \
  --url https://api.social-api.ai/v1/accounts/pending/{connection_id}/select \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "page_ids": [
    "<string>"
  ],
  "platform_account_id": "accounts/123/locations/456"
}
'

201

{
  "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
  "brand_id": "b7e3c1a2-4f5d-4e8a-9b1c-2d3e4f5a6b7c",
  "display_name": "Acme Corp",
  "platform": "instagram",
  "username": "acmecorp"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

connection_id · string · required

Pending connection ID

Body

application/json

Chosen platform_account_id (Google) or page_ids (Facebook)

page_ids · string[]

PageIDs selects the Facebook Pages to assign to the brand (Facebook pending connections only).

platform_account_id · string

PlatformAccountID selects the Google Business Profile to connect (Google pending connections only).

Example:

"accounts/123/locations/456"

Response

201

application/json

Created

account_id · string

Example:

"acc_01HZ9X3Q4R5M6N7P8V2K0W1J"

brand_id · string

BrandID is the brand the account was connected to. When the connect request named no brand, this is the brand created for it.

Example:

"b7e3c1a2-4f5d-4e8a-9b1c-2d3e4f5a6b7c"

display_name · string

Example:

"Acme Corp"

platform · string

Example:

"instagram"

username · string

Example:

"acmecorp"