API resource
Accounts, groups and post review
One connected account in full, whether an Instagram user follows you, the account's webhook subscription with Meta (re-subscribe when lead ads stop arriving), account groups to post to a set of accounts at once, and approving, rejecting, pinning or unpinning posts.
Check whether an Instagram user follows the account
/v1/accounts/{accountId}/follow-status/{userId}Works on: Every network
Path parameters
accountIdstringrequiredInstagram account ID
userIdstringrequiredInstagram-scoped user id (IGSID) from a webhook payload
Query parameters
refreshbooleanBypass the cache and re-query Meta
curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/follow-status/6543210987654321" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"isFollower": true,
"isFollowedByAccount": true,
"followerCount": 0,
"isVerified": true,
"username": "string",
"name": "string",
"unavailableReason": "consent_required"
}Read an account's webhook subscription
/v1/accounts/{accountId}/webhook-subscriptionWorks on: Every network
Path parameters
accountIdstringrequiredcurl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/webhook-subscription" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"pageId": "112233445566",
"appSubscribed": true,
"leadgen": true,
"subscribedFields": [
"string"
],
"warning": "string",
"instagramUserId": "string",
"subscriptionId": "string",
"missingFields": [
"string"
]
}Re-subscribe an account to Creator OS's webhooks
/v1/accounts/{accountId}/webhook-subscriptionWorks on: Every network
Path parameters
accountIdstringrequiredcurl -X POST "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/webhook-subscription" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"resubscribed": true,
"pageId": "112233445566",
"appSubscribed": true,
"leadgen": true,
"subscribedFields": [
"string"
],
"warning": "string",
"instagramUserId": "string",
"subscriptionId": "string",
"previousSubscriptionId": "string",
"recreated": true,
"missingFields": [
"string"
]
}Get account
/v1/accounts/{accountId}Works on: Every network
Path parameters
accountIdstringrequiredcurl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"account": {
"id": "string",
"platform": "social",
"username": "string",
"displayName": "string",
"capabilities": {
"sync": {
"mode": "push",
"typicalDelaySeconds": 0
},
"sentItems": {
"mode": "push",
"typicalDelaySeconds": 0
},
"drafts": {
"supported": true,
"clientEditsVisible": true,
"versioned": true
},
"forward": {
"native": true,
"asAttachment": true
},
"sendAs": {
"list": "provider",
"sharedMailboxes": true
},
"signatures": {
"provider": "read"
},
"labels": {
"model": "labels"
},
"bounces": {
"detection": true
},
"scheduledSend": {
"holdAsDraft": true
},
"tracking": true
},
"platformUserId": "string",
"scopeAreas": [
"string"
],
"oauthAppId": "string",
"tiktokAccountType": "business",
"profilePicture": "string",
"profileUrl": "string",
"isActive": true,
"needsReconnection": true,
"followersCount": 0,
"followersLastUpdated": "2026-10-10T00:00:00.000Z",
"parentAccountId": "string",
"enabled": true,
"metaAdsSyncEnabled": true,
"rateLimitedUntil": "2026-10-10T00:00:00.000Z",
"metadata": {},
"inboundActivity": "string"
}
}Update account
/v1/accounts/{accountId}Works on: Every network
Path parameters
accountIdstringrequiredBody
usernamestringdisplayNamestringxCapabilitiesobjectX only. Per-account opt-in toggles for background API operations that incur X API pass-through costs. Each call is billed at the X tier rate. Either field can be sent independently; omitted fields are unchanged.
metaAdsSyncEnabledbooleanFacebook only (400 invalid_field_value on any other platform). Off by default for every Facebook account. true makes this account sync the Meta ads of the ad accounts it reaches, like a metaads connection.
curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "string"
}'{
"message": "string",
"username": "string",
"displayName": "string",
"xCapabilities": {
"analytics": true,
"inbox": true
},
"metaAdsSyncEnabled": true
}List groups
/v1/account-groupsWorks on: Every network
curl "https://creatoros-production-5658.up.railway.app/v1/account-groups" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"groups": [
{
"id": "string",
"name": "string",
"accountIds": [
"string"
],
"createdBy": "string"
}
]
}Create group
/v1/account-groupsWorks on: Every network
Body
namestringrequiredaccountIdsstring[]requiredcurl -X POST "https://creatoros-production-5658.up.railway.app/v1/account-groups" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"accountIds": [
"string"
]
}'{
"message": "string",
"group": {
"id": "string",
"name": "string",
"accountIds": [
"string"
]
}
}Update group
/v1/account-groups/{groupId}Works on: Every network
Path parameters
groupIdstringrequiredBody
namestringaccountIdsstring[]curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/account-groups/obj_Gr5Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6Kq8Vw1Nx6F" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "string"
}'{
"message": "string",
"group": {}
}Delete group
/v1/account-groups/{groupId}Works on: Every network
Path parameters
groupIdstringrequiredcurl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/account-groups/obj_Gr5Lm9Rc2Hb7Js5Df0Ga8Ue4Ki1Oq6Kq8Vw1Nx6F" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"message": "string"
}Approve or reject a post
/v1/posts/{postId}/reviewWorks on: Every network
Path parameters
postIdstringrequiredBody
decisionstringrequiredapprove schedules the post; reject returns it to draft.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/posts/post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9/review" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"decision": "approve"
}'{
"post": {
"id": "string",
"title": "string",
"content": "string",
"contentNotRetained": true,
"mediaItems": [
{
"type": "image",
"url": "string",
"fileId": "string",
"accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
"title": "string",
"altText": "string",
"filename": "string",
"size": 0,
"mimeType": "string",
"thumbnail": "string",
"instagramThumbnail": "string",
"subtitles": [],
"tiktokProcessed": true
}
],
"platforms": [
{
"platform": "twitter",
"accountId": {},
"customContent": "string",
"customMedia": [],
"scheduledFor": "2026-10-10T00:00:00.000Z",
"platformSpecificData": {},
"status": "pending",
"platformPostId": "1234567890123456789",
"platformPostUrl": "https://twitter.com/acmecorp/status/1234567890123456789",
"publishedAt": "2026-10-10T00:00:00.000Z",
"removedFromPlatformAt": "2026-10-10T00:00:00.000Z",
"isTrialReel": true,
"trialGraduationStrategy": "MANUAL",
"publishAttempts": 0,
"publishRetries": 0,
"errorMessage": "string",
"errorCategory": "auth_expired",
"errorSource": "user",
"platformError": {}
}
],
"scheduledFor": "2026-10-10T00:00:00.000Z",
"timezone": "string",
"status": "draft",
"tags": [
"string"
],
"hashtags": [
"string"
],
"mentions": [
"string"
],
"visibility": "public",
"metadata": {},
"externalId": "string",
"recycling": {
"enabled": true,
"gap": 0,
"gapFreq": "week",
"startDate": "2026-10-10T00:00:00.000Z",
"expireCount": 0,
"expireDate": "2026-10-10T00:00:00.000Z",
"contentVariations": [
"string"
],
"contentVariationIndex": 0,
"recycleCount": 0,
"nextRecycleAt": "2026-10-10T00:00:00.000Z",
"lastRecycledAt": "2026-10-10T00:00:00.000Z"
},
"recycledFromPostId": "string",
"queuedFromProfile": "string",
"queueId": "string",
"createdAt": "2026-10-10T00:00:00.000Z",
"updatedAt": "2026-10-10T00:00:00.000Z"
}
}Pin post
/v1/posts/{postId}/pinWorks on: Every network
Path parameters
postIdstringrequiredBody
platformstringrequiredMust be facebook. Any other value answers 400 platform_not_supported.
accountIdstringWhich Facebook account's copy to change when the post was published to several Facebook accounts. Required in that case.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/posts/post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9/pin" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "facebook"
}'{
"success": true,
"pinned": true,
"platformPostId": "string",
"message": "string"
}Unpin post
/v1/posts/{postId}/unpinWorks on: Every network
Path parameters
postIdstringrequiredBody
platformstringrequiredMust be facebook. Any other value answers 400 platform_not_supported.
accountIdstringWhich Facebook account's copy to change when the post was published to several Facebook accounts. Required in that case.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/posts/post_V9cK2mQ7xL4pR8tN1wZ6bH3jF5dS0aG7eU2iO4kY9/unpin" \
-H "Authorization: Bearer $CREATOROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "facebook"
}'{
"success": true,
"pinned": true,
"platformPostId": "string",
"message": "string"
}