Skip to main content
Social Accounts

List

Retrieve all social accounts connected to your project.

Endpoint

GET https://api.postpeer.dev/v1/connect/integrations

Example

curl "https://api.postpeer.dev/v1/connect/integrations" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "success": true,
  "integrations": [
    {
      "id": "abc123",
      "platform": "twitter",
      "platformUserId": "123456789",
      "displayName": "@yourhandle",
      "imageUrl": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "createdAt": "2026-03-28T10:00:00.000Z"
    },
    {
      "id": "def456",
      "platform": "youtube",
      "platformUserId": "UCxxxxxxxx",
      "displayName": "My Channel",
      "imageUrl": "https://yt3.ggpht.com/.../photo.jpg",
      "createdAt": "2026-03-28T10:05:00.000Z"
    }
  ]
}

Response Fields

FieldTypeDescription
idstringIntegration ID — use this as accountId when creating posts
platformstringPlatform name
platformUserIdstring | nullThe user/account ID on the platform
displayNamestring | nullDisplay name or handle
imageUrlstring | nullProfile image URL
createdAtstringISO 8601 connection timestamp

Status Codes

CodeMeaning
200Success

Connect

Initiate an OAuth flow to connect a social media account.

Disconnect

Remove a connected social account from your project.

On this page

Endpoint
Example
Response
Response Fields
Status Codes