Connecting accounts

An account is one connected identity on a platform: an Instagram profile, a Facebook Page, a Slack channel, a Shopify store, a Gmail mailbox. Every account lives inside a profile. You connect it once, then post, read and reply through its accountId.

This page explains the connect methods, the flow most platforms use, and what to do after an account is connected.

#Connect methods

Each platform uses one of four methods. The method decides whether the user leaves your app and what you have to collect.

Credentials and bots covers the second and third rows. Phone numbers are covered in Phone, SMS & voice.

#The OAuth flow

Most connects follow the same five steps, whatever the platform.

curl "https://api.pozy.ai/v1/connect/linkedin?profileId=6650c1f2a9e4b7d3c8a1f0e2&redirect_url=https://app.example.com/connected" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/connect/linkedin?profileId=6650c1f2a9e4b7d3c8a1f0e2&redirect_url=https:%2F%2Fapp.example.com%2Fconnected", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
// Send the user's browser to data.authUrl

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/connect/linkedin",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"profileId": "6650c1f2a9e4b7d3c8a1f0e2", "redirect_url": "https://app.example.com/connected"},
    timeout=30,
)
auth_url = resp.json()["authUrl"]

https://app.example.com/connected?connected=linkedin&profileId=6650c1f2a9e4b7d3c8a1f0e2&accountId=6651d3a7b2c9e4f1a0b8c7d6&username=acme&stage=callback&request_id=req_...

The hosted connect pages guide covers every parameter, the success and error redirects, and what your users see along the way.

#After an account is connected

A profile can hold several accounts on the same platform. Connecting a different account adds a new one. Connecting the same account again keeps its accountId and its history, so a reconnect never breaks your stored ids. Ads connections are the exception: one per platform per profile.

#Billing gates

Connecting an account can return 402 payment_required when:

The response carries a dashboard_url that opens billing in the dashboard. Send the workspace owner there. See Pricing for what each account costs.

#Webhook events

#In this section

#Endpoints

Every connect endpoint, including each platform's selection and credential calls, is listed under Connect in the API reference.