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: May 2026
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});Manual first comments
What bundle.social handles
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.
Create an API key
Generate an organization API key in the dashboard and use it with the x-api-key header.
Schedule the post
Create the main post and receive a post ID. The post ID is required to attach the first comment.
Attach the first comment
POST to /api/v1/comment with the bundlePostId. The comment fires after the post publishes on the supported platform.
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.
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
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
2% error rate
We handle the platform edge cases, media processing, and rate limits so your requests succeed.
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. Test us c;
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.