Post Callbacks

Automate follow-up actions when you publish or schedule posts: auto-share to other accounts, post delayed comments, or auto-delete content after a set time.

Overview

Post callbacks are powerful automation features that can be configured within your API requests when creating posts. They allow you to:

• AutoShare: Automatically share published posts to other social accounts

• Follow-up Comments: Schedule comments to be posted after the original post is published

• Auto-Delete: Automatically remove posts after a specified time period on the specified networks

Endpoints

• Schedule with callbacks: POST /api/v1/posts/schedule

• Publish now with callbacks: POST /api/v1/posts/schedule/publish

Callbacks live inside each account object in your request payload.

Request Structure

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "Your post content here"
          }
        },
        "accounts": [
          {
            "id": "ACCOUNT_ID",
            "scheduled_at": "2025-05-15T14:30:00Z", // Optional for immediate publishing
            "share":   { /* AutoShare config */ },
            "comments":[ /* Follow-up comments */ ],
            "delete":  { /* Auto-Delete config */ }
          }
        ]
      }
    ]
  }
}

Auto-Sharing

Automatically share your published post to other accounts.

Parameters

Field	Type	Description
share.text	string	Custom caption for the shared post (defaults to original text).
share.account_ids	string[]	Target account IDs for auto-sharing.
share.after.duration	number	Delay value before first share.
share.after.unit	string	Time unit: Minute, Hour, Day, Week.
share.delay.duration	number	Delay between shares to multiple accounts.
share.delay.unit	string	Time unit for delay: Minute, Hour, Day, Week.

Example

"share": {
  "text": "Check out our latest blog post!",
  "account_ids": ["A_ID_1", "A_ID_2"],
  "after": { "duration": 1, "unit": "Hour" },
  "delay": { "duration": 15, "unit": "Minute" }
}

Supported Networks

Facebook Pages→Groups, Twitter/X, LinkedIn, Pinterest, Mastodon, Threads, BlueSky, TikTok, Telegram, Google Business.

Note: Google Business Profiles require non-empty text. Push-notification posts cannot be auto-shared.

Follow-Up Comments

Schedule comments on your own post at specified delays.

Parameters

Field	Type	Description
comments[].text	string	Comment text.
comments[].language	string	Language code (optional).
comments[].delay.duration	number	Delay value after original post.
comments[].delay.unit	string	Minute, Hour, Day, or Week.
comments[].media	object	Optional media to include in the comment.
comments[].media.type	string	photo, video, or gif.
comments[].media.path	string	File path or URL for the media.
comments[].media.caption	string	Caption for the attached media (optional).
comments[].media.thumbnail	string	Thumbnail URL for video media (optional).

Example

"comments": [
  {
    "text": "First 100 customers get 10% off!",
    "delay": { "duration": 2, "unit": "Hour" }
  },
  {
    "text": "24 hours left—don’t miss out!",
    "delay": { "duration": 1, "unit": "Day" },
    "media": {
      "type": "photo",
      "path": "/path/to/countdown.jpg",
      "caption": "Only one day left!"
    }
  }
]

Supported Networks

Twitter/X, LinkedIn, Facebook Pages→Groups (when posting as a Page to a Group), Mastodon, Threads, BlueSky.

For Twitter/X, Mastodon, BlueSky, and Threads, comments become new posts in a thread. Recurring posts carry their comments each time; drafts and re-schedules require manual comment setup.

Auto-Delete

Automatically hide or delete a post after a set time.

Parameters

Field	Type	Description
delete.hide	boolean	true to hide instead of delete (platform-dependent).
delete.delay.duration	number	Delay value after original post.
delete.delay.unit	string	Time unit: Minute, Hour, Day, or Week.

Example

"delete": {
  "hide": false,
  "delay": { "duration": 7, "unit": "Day" }
}

Supported Networks

All scheduled networks except Instagram and story formats on Facebook/Instagram.

Instagram API does not support auto-delete. Certain post types (e.g., Stories) cannot be auto-deleted.

Complete Example

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "Annual sale starts tomorrow—50% off sitewide!"
          }
        },
        "accounts": [
          {
            "id": "A_ID_MAIN",
            "scheduled_at": "2025-05-15T14:30:00Z",
            "share": {
              "text": "Don't miss our HUGE sale!",
              "account_ids": ["A_ID_2", "A_ID_3"],
              "after": { "duration": 1, "unit": "Hour" },
              "delay": { "duration": 15, "unit": "Minute" }
            },
            "comments": [
              {
                "text": "Extra 10% off for first 100 buyers!",
                "delay": { "duration": 2, "unit": "Hour" }
              }
            ],
            "delete": {
              "hide": false,
              "delay": { "duration": 2, "unit": "Day" }
            }
          }
        ]
      }
    ]
  }
}

Best Practices

• AutoShare: Provide custom text, respect audience time zones, and space out shares.

• Comments: Keep them relevant, varied (text/media), and well-timed to maintain engagement.

• Auto-Delete: Use for time-sensitive offers; prefer hiding to preserve history.

Related Topics

• Content Types - Details on different content formats

• Scheduled Posts - Information about scheduling posts

• Immediate Publishing - How to publish content immediately