Instagram collab posts through the API
Instagram's API publishes a collab post when the media container carries collaborators, a list of up to 3 Instagram usernames, on a Feed photo, a Reel or a carousel; Stories are not supported. Each invited account receives a request it can accept or decline, and the post appears on its profile once accepted. Meta documents collaborator tags for Facebook Login for Business only.
easyCoexistence publishes photos, carousels and Reels with publish_instagram_post from Claude, ChatGPT or your own code, through Instagram Login, and the collaborators are then added to the post in the Instagram app, where each one accepts.
Instagram usernames the collaborators parameter takes on one media container.
Accounts Meta's collaborators reference says can be added as collaborators on a post.
Collaborator tags in the API are documented for Facebook Login for Business only.
The invite_status of a collaborator who has not accepted yet; it reads Accepted once they have.
Accept or decline calls an invited account can make through the Collaboration API in 24 hours.
How is a collab post published through the API?
With the usual two calls and one extra parameter. Create the container with POST /<IG_ID>/media, adding collaborators with up to 3 Instagram usernames to an image, Reel or carousel container, then publish it with media_publish. Meta's reference shows the call on graph.facebook.com, with the instagram_basic and instagram_content_publish permissions of Facebook Login.
POST https://graph.facebook.com/<IG_ID>/media
?image_url=https://www.example.com/images/launch.jpg
&caption=<CAPTION>
&collaborators=['username1','username2']
&access_token=<ACCESS_TOKEN>Which posts can have collaborators?
Feed photos, Reels and carousels. Meta's reference lists the collaborators parameter for those three and marks it not supported for Stories. On a carousel, Meta's request syntax puts it on the carousel container, beside the caption, and the post counts once toward the account's 100 API-published posts in 24 hours.
Who has to accept?
Each invited account. Instagram sends it a request to accept or decline; once it accepts, the post also appears on its profile, reaches its followers' feeds and is credited to both accounts in its header. Instagram's Help Center adds that the author can add or remove collaborators at any time, and that a collaborator can leave whenever they choose.
How do you check whether a collaborator accepted?
With GET /<IG_MEDIA_ID>/collaborators, documented for Facebook Login. It lists each invited account's id, username and invite_status, Accepted or Pending, and returns only accounts that have enabled collaborator tagging. Meta's reference for this edge says up to 5 accounts can be added as collaborators; the container parameter takes up to 3.
{
"data": [
{ "id": "<ID>", "username": "username1", "invite_status": "Accepted" },
{ "id": "<ID>", "username": "username2", "invite_status": "Pending" }
]
}Can an invited account accept through the API?
Yes, with Meta's Collaboration API, available with Facebook Login and Unified Login. GET /<IG_USER_ID>/collaboration_invites lists pending invitations, at up to 300 calls per user a day, and POST /<IG_USER_ID>/collaboration_invites with media_id and accept set to true or false answers one, at up to 50 calls per user a day. Both need instagram_basic.
What can a collaborator read about the post?
Little, by design. Meta says data on co-authored media can, with a few exceptions, be read through the API only by the account that published it. Since April 2026, GET /<IG_USER_ID>/collaborative_media lists the media where the user is an accepted collaborator, with Facebook Login, and a collaborator removed by the owner loses access to the post.
How do you make a collab post with easyCoexistence?
In two steps. publish_instagram_post publishes the photo, carousel or Reel from Claude, ChatGPT or your own code; it takes no collaborators, since easyCoexistence connects Instagram with Instagram Login, which Meta's collaborator tags do not cover. Then add the collaborators to the post in the Instagram app, where the author can add them at any time and each one accepts as usual.
Common mistakes
- Adding collaborators to a Story container. Meta supports them on Feed photos, Reels and carousels only.
- Listing more than 3 usernames on one container. The collaborators parameter takes up to 3.
- Expecting the post on the collaborator's profile at once. It appears there only after the invited account accepts.
- Sending collaborators with an Instagram Login token. Meta documents the parameter for setups on Facebook Login for Business, not for Instagram Login.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can the Instagram API create collab posts?
Yes, with Facebook Login for Business: add collaborators, up to 3 usernames, to a Feed photo, Reel or carousel container before publishing it.
How many collaborators can an Instagram post have?
Up to 3 through the collaborators parameter on a container. Meta's collaborators reference says up to 5 accounts can be added to a post.
Do collaborators have to accept?
Yes. Each invited account accepts or declines, and the post shows on its profile only once it has accepted.
Can a Story be a collab post through the API?
No. Meta lists collaborators for Feed photos, Reels and carousels, and marks Stories as not supported.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on