POST
https://www.app.ocoya.com/api/_public/v1/social-profiles/connection-url
Generate social connection URL
curl --request POST \
  --url https://www.app.ocoya.com/api/_public/v1/social-profiles/connection-url \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "provider": "instagram"
}
'
{
  "url": "https://www.app.ocoya.com/api/social-connect/start?provider=instagram&brandId=cmayvq3hk00017apshay5qezu"
}

Authorizations

X-API-Keystringheaderrequired

Your API key. Create one in Ocoya. Authorization: Bearer <key> works too.

Query Parameters

brandIdstringrequired

Ocoya brand ID. Get one from GET /brands.

Example:"cmayvq3hk00017apshay5qezu"

Body

application/json
providerenum<string>required

Network used for the connection flow. Webflow and Framer connect CMS collections, and Wix a site's blog, that receive articles. Framer, DEV.to, WordPress, Bluesky and Mastodon ask for a key or a site address, so their URL opens Ocoya's integrations panel, where the person picks the network and fills in its form.

Available options: facebook, instagram, x, linkedin, pinterest, threads, tiktok, youtube, google, bluesky, discord, mastodon, dribbble, tumblr, wordpress, devto, whop, notion, airtable, webflow, framer, wix, twitch, kick, snapchat, reddit, webhook, telegram, slack
Example:"instagram"

Response

application/json

Success

urlstring

Browser URL to open while signed in to Ocoya to start the connection flow.

Example:
"https://www.app.ocoya.com/api/social-connect/start?provider=instagram&brandId=cmayvq3hk00017apshay5qezu"