PostHero API

v1 Reference

Auto-plug (LinkedIn comments)

LinkedIn only. Auto-plug schedules a chain of comments that PostHero posts on your *own* LinkedIn post after it publishes. Useful for the "drop a link in the first comment" pattern, follow-up CTAs, or threading thoughts that don't fit in the main post. How it works: - Set isAutoPlug: true on the post. - Provide autoPlug as an array of { comment, delay, image? } objects. - delay is in milliseconds. The first comment fires delay ms after the post publishes. Each subsequent comment fires delay ms after the *previous* comment. - image is optional — pass an HTTPS URL (or one returned by Upload Media) to attach an image to the comment. - Only fires for the LinkedIn publish in your platforms array. Other platforms ignore these fields. The dashboard UI offers preset delays (30000 / 60000 / 180000 / 300000 — i.e. 30 s, 1 min, 3 min, 5 min). The API accepts any positive number. After each auto-plug comment publishes successfully, the corresponding entry in autoPlug gets a commentIdOnPlatform field added with the LinkedIn comment ID (visible on subsequent GETs).

Required fields

NameTypeDescription
isAutoPlug*booleanSet true to enable auto-plug for the LinkedIn publish.
autoPlug*arrayArray of comment objects to post after publish.
autoPlug[].comment*stringThe comment text.
autoPlug[].delay*numberDelay in milliseconds before this comment is posted (from publish time for the first entry; from the previous comment for subsequent entries).
autoPlug[].imagestringOptional HTTPS URL of an image to attach to the comment.

Example request

// Schedule a LinkedIn post with two follow-up comments —
// first comment 1 minute after the post, second comment 3 minutes after that.
curl --request POST \
  --url https://server.posthero.ai/api/v1/posts \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "text": "Just shipped our new API! Excited to see what people build with it.",
  "platforms": [
    { "platform": "linkedin", "accountId": "acc_li_1" }
  ],
  "isAutoPlug": true,
  "autoPlug": [
    { "comment": "Docs are here: https://posthero.ai/docs/api", "delay": 60000 },
    { "comment": "Reply or DM if you hit anything weird — happy to help.", "delay": 180000 }
  ],
  "publishNow": true
}'