Distribution Accounts and History

List connected Instagram and TikTok accounts, then review publish history for each surface.

What this surface covers

This surface is separate from the direct publish endpoints. Use it to discover connected accounts and inspect publish history, especially when you need cursor-based pagination or need to filter previous Instagram and TikTok publishes.

Instagram accounts

GET/api/v1/instagram/accounts

Returns connected Instagram accounts that are currently active for the authenticated Wonda account.

{
  "accounts": [
    {
      "instagramAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "igUserId": "17841400000000000",
      "username": "wonda",
      "accountType": "BUSINESS",
      "status": "active",
      "scopes": ["instagram_basic", "instagram_content_publish"]
    }
  ]
}

TikTok accounts

GET/api/v1/tiktok/accounts

Returns connected TikTok accounts that are currently active for the authenticated Wonda account.

{
  "accounts": [
    {
      "tiktokAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "tiktokUserId": "1234567890",
      "username": "wonda",
      "displayName": "Wonda Studio",
      "avatarUrl": "https://...",
      "status": "active",
      "grantedScopes": ["video.publish", "user.info.basic"]
    }
  ]
}

Instagram publish history

GET/api/v1/instagram/publishes

Parameter	Type	Required	Description
limit	number	No	Maximum number of rows to return. Defaults to 10.
status	queued \| in_progress \| succeeded \| failed	No	Filter by publish status.
product	IMAGE \| REELS \| STORIES \| CAROUSEL	No	Filter by Instagram product type.
instagramAccountId	string (UUID)	No	Filter by a specific connected Instagram account.
cursorCreatedAt	string (datetime)	No	Cursor timestamp for pagination. Must be provided with cursorInstagramPublishId.
cursorInstagramPublishId	string (UUID)	No	Cursor publish ID for pagination. Must be provided with cursorCreatedAt.

The cursor pair must always travel together. The response returns a nextCursor object when more rows are available.

{
  "items": [
    {
      "instagramPublishId": "b2d7e2ae-1d3d-4c88-8f01-0d2c8fb2d9b1",
      "instagramAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "product": "CAROUSEL",
      "status": "succeeded",
      "sourceUrl": "https://...",
      "caption": "Spring launch",
      "altText": null,
      "containerId": "1789...",
      "igMediaId": "1789...",
      "permalink": "https://instagram.com/p/...",
      "createdAt": "2026-03-19T12:34:56.000Z",
      "publishedAt": "2026-03-19T12:35:45.000Z"
    }
  ],
  "nextCursor": {
    "createdAt": "2026-03-19T12:34:56.000Z",
    "instagramPublishId": "b2d7e2ae-1d3d-4c88-8f01-0d2c8fb2d9b1"
  }
}

TikTok publish history

GET/api/v1/tiktok/publishes

Parameter	Type	Required	Description
limit	number	No	Maximum number of rows to return. Defaults to 10.
status	queued \| in_progress \| succeeded \| failed	No	Filter by publish status.
tiktokAccountId	string (UUID)	No	Filter by a specific connected TikTok account.
cursorCreatedAt	string (datetime)	No	Cursor timestamp for pagination. Must be provided with cursorTiktokPublishId.
cursorTiktokPublishId	string (UUID)	No	Cursor publish ID for pagination. Must be provided with cursorCreatedAt.

TikTok history uses the same cursor pattern as Instagram. The response includes nextCursor only when more rows are available.

{
  "items": [
    {
      "tiktokPublishId": "c34a4b1f-b2ff-4f3f-a4fb-6cf2ca8f9e2c",
      "tiktokAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "sourceUrl": "https://...",
      "caption": "Launch day",
      "privacyLevel": "SELF_ONLY",
      "status": "succeeded",
      "publishId": "v0...",
      "tiktokMediaId": "v0...",
      "isAigc": true,
      "errorCode": null,
      "errorMessage": null,
      "createdAt": "2026-03-19T12:34:56.000Z",
      "publishedAt": "2026-03-19T12:35:45.000Z"
    }
  ],
  "nextCursor": {
    "createdAt": "2026-03-19T12:34:56.000Z",
    "tiktokPublishId": "c34a4b1f-b2ff-4f3f-a4fb-6cf2ca8f9e2c"
  }
}