Skip to main content

List Accounts

GET /developers/v1/accounts​

Returns all social media accounts connected to the authenticated user's SchedPilot profile. Use the id and type values from this response when calling Create Post.

Request​

No query parameters or request body.

Headers​

HeaderRequiredDescription
X-API-KEYYes*Your personal API key.
AuthorizationYes*Bearer token: Bearer sp_tok_xxxxxxx.

*Provide one of the two authentication headers.

Example request​

curl https://api.schedpilot.com/developers/v1/accounts \
  -H "X-API-KEY: smm_4a9f3c1e8b205d7a6e0f2c49b8d3a15f"

Response​

Status: 200 OK

Returns a JSON object with a single key accounts, whose value is an array of account objects.

Account object fields​

FieldTypeDescription
idintegerUnique identifier for the connected account. Use this when creating posts.
typestringPlatform identifier. One of: twitter, linkedin, linkedin_page, instagram, facebook, threads, bluesky, pinterest, youtube, tiktok.
namestringDisplay name of the account as it appears on the platform.
usernamestringPlatform handle or username (without the @ prefix).
picturestringURL of the account's profile image.

Example response​

{
  "accounts": [
    {
      "id": 12,
      "type": "twitter",
      "name": "Acme Corp",
      "username": "acmecorp",
      "picture": "https://pbs.twimg.com/profile_images/123456789/photo.jpg"
    },
    {
      "id": 17,
      "type": "linkedin",
      "name": "Jane Smith",
      "username": "janesmith",
      "picture": "https://media.licdn.com/dms/image/C4D03AQH_example/photo.jpg"
    },
    {
      "id": 23,
      "type": "instagram",
      "name": "acmecorp_official",
      "username": "acmecorp_official",
      "picture": "https://cdninstagram.com/v/t51.2885-19/example.jpg"
    }
  ]
}

Error responses​

StatusDescription
401 UnauthorizedMissing or invalid authentication credentials.
429 Too Many RequestsRead rate limit exceeded (60 requests/hour).

Notes​

  • The list reflects accounts that are currently connected and have valid OAuth tokens. If a user disconnects a platform account from the SchedPilot dashboard, it will no longer appear here.
  • Store the id and type values together — both are required when specifying accounts in a Create Post request.
  • For linkedin_page, the name is the page name and username is the page slug.