Schedule First Comment

Schedule first comment API for links, CTAs, and cleaner captions

Use the bundle.social comment API to attach a first comment to any published post. Keep captions tight and move CTAs, hashtags, and resource links into a timed follow-up comment.

Last updated: July 2026

One API key. No per-account fees. 15 platforms.

API key authScheduled publishing15 platforms
Quick start
API request
1// Step 1: Schedule the post2const post = await fetch("https://api.bundle.social/api/v1/post", {3  method: "POST",4  headers: {5    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,6    "Content-Type": "application/json"7  },8  body: JSON.stringify({9    teamId: "team_123",10    title: "Product launch post",11    postDate: "2026-05-14T10:00:00.000Z",12    status: "SCHEDULED",13    socialAccountTypes: ["INSTAGRAM"],14    data: {15      INSTAGRAM: { type: "POST", text: "Big news today.", uploadIds: ["upload_img_1"] }16    }17  })18});19const { id: postId } = await post.json();2021// Step 2: Schedule the first comment on the same post22await fetch("https://api.bundle.social/api/v1/comment", {23  method: "POST",24  headers: {25    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,26    "Content-Type": "application/json"27  },28  body: JSON.stringify({29    teamId: "team_123",30    bundlePostId: postId,31    text: "Full thread and links: link.to/launch"32  })33});
Official APIs500k+ connected accountsDirect engineer support

Manual first comments

Manual first comments are easy to forget and hard to coordinate across teams.
Each platform treats comments, links, character limits, and pinned comments differently.
Bulk scheduling gets messy when the first comment lives in a separate checklist.

What bundle.social handles

Use the same comment API endpoint to attach a first comment to any bundle.social post.
Keep first-comment planning attached to the scheduled post so nothing is left to manual follow-up.
Give marketers a cleaner way to plan CTAs, resource links, and hashtag blocks without cluttering captions.

First comments ship through the same API as everything else

The bundle.social comment endpoint works for first comments too. Schedule the post, get back the post ID, then attach the comment payload. Captions stay clean. CTAs land on time.

Workflow

How it works

Schedule the post first, then attach the first comment via the comment endpoint using the returned post ID.

01

Create an API key

Generate an organization API key in the dashboard and use it with the x-api-key header.

02

Schedule the post

Create the main post and receive a post ID. The post ID is required to attach the first comment.

03

Attach the first comment

POST to /api/v1/comment with the bundlePostId. The comment fires after the post publishes on the supported platform.

Product architecture

Build social media workflows without rebuilding every platform

Schedule first comment API for CTAs, links, and cleaner captions

Social teams, agencies, creator tools, and AI content products that publish on Instagram and LinkedIn want the caption to carry the hook while links, hashtag sets, resources, and calls to action move into a timed follow-up comment. Handled manually, that step depends on someone remembering it minutes after every post goes live.

bundle.social attaches the first comment to the scheduled post itself. Your backend creates the post, receives its ID, and sends the comment payload with that bundlePostId, so the follow-up ships with the content plan rather than a checklist. Marketing teams can review both parts in the dashboard before anything publishes.

The first comment is part of the content plan, not a publishing toggle

Captions compete for attention with everything a marketer wants to add to them. Hashtag blocks, campaign links, disclaimers, and resource lists all push the hook further down the post, which is why first comments became a caption strategy rather than a technical trick. Planning them separately from the post is what makes them unreliable.

A better workflow keeps caption, media, schedule, and first comment as one reviewed unit. bundle.social uses the same comment endpoint for first comments as for every other reply, so there is no second integration to maintain and no separate approval path for the text that ships underneath the post.

Platform support decides where first comments belong

First-comment behavior follows each platform's comment API and the connected account's permissions. Instagram feed posts and Reels support the pattern well, LinkedIn is a common use case for links and documents, Instagram Stories have no comparable public comment model, and pinned comments exist only where the native platform exposes them.

bundle.social keeps those limits visible so product teams can plan first comments for the channels where they earn something and omit them elsewhere. The post, its comment, its status, and its analytics stay in the same workspace as the rest of the campaign instead of in a separate engagement tool.

Capabilities

First-comment workflows that keep posts clean

Plan CTAs, hashtags, and links in a first comment so captions stay focused, scheduled alongside the post.

Real comment API endpoint

POST to /api/v1/comment with a bundlePostId to create a first comment. The same endpoint handles all comment workflows.

Keep captions clean

Move links, hashtags, and resource blocks to a first comment instead of cluttering the caption.

CTA delivery after publishing

Schedule the follow-up comment to appear right after the main post goes live so the CTA is always timed correctly.

Hashtag strategy in comments

Place hashtag sets in a comment to preserve caption readability on Instagram and LinkedIn.

One workflow for post and comment

Plan the first comment alongside the scheduled post so nothing falls through a checklist gap.

Dashboard visibility for marketing teams

Non-technical teammates can see and review the comment plan in the dashboard without reading API docs.

Developer example

Schedule a post and attach a first comment

Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.

TypeScript
API request
1// Step 1: Create the scheduled post2const postRes = await fetch("https://api.bundle.social/api/v1/post", {3  method: "POST",4  headers: {5    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,6    "Content-Type": "application/json"7  },8  body: JSON.stringify({9    teamId: "team_123",10    title: "Launch week post",11    postDate: "2026-05-14T10:00:00.000Z",12    status: "SCHEDULED",13    socialAccountTypes: ["INSTAGRAM", "LINKEDIN"],14    data: {15      INSTAGRAM: { type: "POST", text: "Something big is here.", uploadIds: ["upload_img_1"] },16      LINKEDIN: { text: "We launched something today. Details below." }17    }18  })19});20const { id: postId } = await postRes.json();2122// Step 2: Attach a first comment to the scheduled post23await fetch("https://api.bundle.social/api/v1/comment", {24  method: "POST",25  headers: {26    "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,27    "Content-Type": "application/json"28  },29  body: JSON.stringify({30    teamId: "team_123",31    bundlePostId: postId,32    text: "Full breakdown and links at: bundle.social/blog/launch"33  })34});

Supported content

First commentsCTAsHashtagsResource linksExtra context

Honest limitations

  • First-comment support depends on platform comment APIs and connected account permissions.
  • Instagram Stories do not support public comments in the same way feed posts do.
  • Pinned comments are not universally available through native APIs.

Guarantees

Developer-first infrastructure

Visible post status

Track scheduled, processing, posted, retrying, and error states per post.

Verbose errors

When native APIs fail, we return human-readable error messages and actionable recovery steps.

Flat pricing

No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.

Same-day support

Direct access to the engineers building the API. We respond to technical issues the same day, sometimes the same hour.

FAQ

Questions developers ask before building

How do I schedule a first comment?

Create the post first using the POST /api/v1/post endpoint. Receive the post ID in the response, then POST to /api/v1/comment with the bundlePostId field set to that ID.

Can I schedule a first comment on every platform?

Support depends on each platform's comment API and the connected account's permissions. Check the platform-specific docs for current availability.

Why use first comments?

They keep captions cleaner while still giving you room for links, resources, hashtags, or follow-up context.

Does this work for Instagram Stories?

No. Stories do not have the same public comment model as feed posts or Reels.

Can first comments be pinned?

Only where the native platform exposes that behavior. Treat pinned comments as platform-specific, not universal.