Posts
Post a first comment on Instagram via API
With instagram.first_comment, the account itself comments right after publishing. It is handy for hashtags, links and calls to action without cluttering the caption, and it works on feed and reels.
The request
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "post-4410",
"format": "feed",
"caption": "Nova coleção no ar",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/colecao.jpg"
}
],
"instagram": {
"first_comment": "#colecao #verao #moda",
"comments_disabled": false
}
}What you can do
- Comment from the account itself right after the post.
- Put hashtags or supporting text outside the caption.
- Turn comments off after publishing with instagram.comments_disabled.
- Use it on image posts, carousels and reels, on instagram and instagram_business accounts.
Rules and limits
- first_comment takes up to 2200 characters.
- It only works on format feed and reels. Stories do not accept it.
- The comment is posted by the account itself, right after the post.
- The answer is 202: publishing runs in the background. Follow it with GET /posts/{uuid}.
- external_reference is required and Idempotency-Key avoids duplicating.
Main fields
| Field | Type | Required | Description |
|---|---|---|---|
| external_reference | string | Yes | The post's id in your system (up to 100 characters). Prevents publishing the same post twice on the same account. |
| format | string | Yes | Post format. On Instagram: feed, reels or story. On Facebook: feed, reels or story. |
| caption | string | No | Caption. On Instagram, up to 2200 characters, 30 hashtags and 20 mentions. Stories carry no caption. |
| media | array | Yes | List of media, in order. Each item has type and url. |
| instagram.first_comment | string | No | Comment posted by the account right after the post, up to 2200 characters. Feed and reels only. |
| instagram.comments_disabled | boolean | No | Turns comments off after publishing. Feed and reels only. |
Who it is for
Hashtags outside the caption
Your SaaS publishes a clean caption and sends the hashtags in the first comment.
Call to action
A store publishes the product and comments the purchase link or coupon right after.
AI agent
An agent generates caption and comment separately and publishes both in one call.
Works with
Instagram Business
Instagram
Frequently asked questions
Who posts the first comment?
The connected account itself, right after the post.
Can I use it on stories?
No. first_comment only works on feed and reels.
What is the maximum length?
Up to 2200 characters.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
