First comments

A first comment is a comment Pozy adds to your own post right after it publishes. It is where links go on platforms that hide or penalise them in the caption, and where you put hashtags, credits or a call to action without cluttering the post itself. Set it with firstComment in the entry's platformSpecificData.

#Add a first comment

curl -X POST https://api.pozy.ai/v1/posts \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our 2026 pricing report is out: what 400 SaaS companies charge, and why.",
    "mediaItems": [{ "type": "image", "url": "https://pozy.ai/media/temp/1730289600_p3r6_report.png" }],
    "scheduledFor": "2026-11-10T09:00:00",
    "timezone": "Europe/Berlin",
    "platforms": [
      {
        "platform": "linkedin",
        "accountId": "6710c3e2a9f14b0d8e5c7a21",
        "platformSpecificData": { "firstComment": "Read the full report: https://example.com/pricing-2026" }
      },
      {
        "platform": "instagram",
        "accountId": "6710c3e2a9f14b0d8e5c7a22",
        "platformSpecificData": { "firstComment": "#saas #pricing #startups" }
      }
    ]
  }'

const res = await fetch("https://api.pozy.ai/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Our 2026 pricing report is out: what 400 SaaS companies charge, and why.",
    mediaItems: [{ type: "image", url: "https://pozy.ai/media/temp/1730289600_p3r6_report.png" }],
    scheduledFor: "2026-11-10T09:00:00",
    timezone: "Europe/Berlin",
    platforms: [
      {
        platform: "linkedin",
        accountId: "6710c3e2a9f14b0d8e5c7a21",
        platformSpecificData: { firstComment: "Read the full report: https://example.com/pricing-2026" },
      },
      {
        platform: "instagram",
        accountId: "6710c3e2a9f14b0d8e5c7a22",
        platformSpecificData: { firstComment: "#saas #pricing #startups" },
      },
    ],
  }),
});
if (!res.ok) throw new Error((await res.json()).error);

requests.post(
    "https://api.pozy.ai/v1/posts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Our 2026 pricing report is out: what 400 SaaS companies charge, and why.",
        "mediaItems": [{"type": "image", "url": "https://pozy.ai/media/temp/1730289600_p3r6_report.png"}],
        "scheduledFor": "2026-11-10T09:00:00",
        "timezone": "Europe/Berlin",
        "platforms": [
            {
                "platform": "linkedin",
                "accountId": "6710c3e2a9f14b0d8e5c7a21",
                "platformSpecificData": {"firstComment": "Read the full report: https://example.com/pricing-2026"},
            },
            {
                "platform": "instagram",
                "accountId": "6710c3e2a9f14b0d8e5c7a22",
                "platformSpecificData": {"firstComment": "#saas #pricing #startups"},
            },
        ],
    },
    timeout=30,
).raise_for_status()

The comment is posted from the same account, after the post itself is live. For a scheduled post that is at the scheduled time, not when you create the post.

#Where first comments work

Platform	Supported on	Limit and behaviour
Instagram	Feed posts and carousels	Not on Stories. Captions cannot hold clickable links, so this is the usual place for them.
Facebook	Feed posts and Reels	Not on Stories. Skipped when `facebookSettings.draft` is `true`.
LinkedIn	Every post type	LinkedIn shows posts with a link in the text to fewer people, so a link in the first comment usually reaches more. Supports the same `@[...]` mentions as the post text.
YouTube	Videos and Shorts	Up to 10,000 characters. Posted and pinned to the top of the comments.
Threads	Every post type	Up to 500 characters. Posted as a reply to your post; with `threadItems`, a reply to the first post of the thread. It counts as one more Threads post toward the platform's daily limit.

X, Bluesky and the other platforms have no firstComment. On X and Bluesky, add a follow-up post with threadItems instead.

#Things to know

Drafts skip it. A first comment is never posted for a draft, including TikTok and Facebook platform drafts.
It is a real comment. It is posted by your account and appears with the post's other comments, so you can read and moderate it from the inbox.
Set it before publishing. A published post cannot be updated, so firstComment cannot be added or changed afterwards. From then on the comment is managed like any other comment in the inbox.

#Endpoints

Endpoint	What it does
`POST /v1/posts`	Create post
`PUT /v1/posts/{postId}`	Update post