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

FieldTypeRequiredDescription
external_referencestringYesThe post's id in your system (up to 100 characters). Prevents publishing the same post twice on the same account.
formatstringYesPost format. On Instagram: feed, reels or story. On Facebook: feed, reels or story.
captionstringNoCaption. On Instagram, up to 2200 characters, 30 hashtags and 20 mentions. Stories carry no caption.
mediaarrayYesList of media, in order. Each item has type and url.
instagram.first_commentstringNoComment posted by the account right after the post, up to 2200 characters. Feed and reels only.
instagram.comments_disabledbooleanNoTurns 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.

Related

See everything you can do with Posts

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.