Connect API

The /v1/connect endpoint handles unified OAuth for all platforms.

Get the connection URL

{ "scopes": ["tweet.read", "tweet.write"] }

{
  "connectUrl": "https://api.pepe.business/oauth/abc123",
  "state": "pending",
  "expiresAt": "2026-07-13T11:00:00Z"
}

Supported platforms: twitter, instagram, facebook, linkedin, tiktok, youtube, pinterest, reddit, bluesky, threads, snapchat, google-business, whatsapp, telegram, discord.

OAuth callback

pepe.business handles the callback automatically. You don't have to code anything.

Once OAuth succeeds, you receive an account.connected webhook:

{
  "eventId": "evt_xxx",
  "type": "account.connected",
  "data": {
    "accountId": "acc_xxx",
    "platform": "twitter",
    "handle": "@alice",
    "profileId": "prof_xxx"
  }
}

Connect WhatsApp/Telegram without OAuth

WhatsApp Business and Telegram use a different flow:

{ "phoneNumberId": "phn_xxx" }

{ "botToken": "123456:ABC-DEF..." }

List pages/orgs/boards

For Facebook, LinkedIn, Pinterest — after OAuth, select the resource to publish to:

{
  "pages": [
    { "id": "fb_page_xxx", "name": "My Page", "category": "Business" }
  ]
}

Select a resource

{ "pageId": "fb_page_xxx" }

Pending OAuth data

If the user hasn't completed the OAuth flow:

{
  "state": "pending",
  "createdAt": "2026-07-13T10:00:00Z",
  "expiresAt": "2026-07-13T11:00:00Z"
}