Buffer

Create, schedule, publish, and manage queued posts across Buffer profiles.

Add a post to a profile's Buffer queue. Buffer publishes it at the profile's next open posting slot, or at a specific time if you set a schedule.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	The ID of the Buffer profile (a connected social account) to post to. Use 'List connected profiles' to find it.
`text`	string	Yes	The text of the post to publish.
`scheduled_at`	string	No	Optional. When to publish the post, as a date and time in ISO 8601 format, for example 2026-07-15T09:00:00Z. Leave blank to add it to the end of the queue.

Response

{
  "status": "success",
  "update": {
    "id": "5f8d9e1a2b3c4d5e",
    "status": "pending"
  }
}

Remove a post from a Buffer profile's queue.

Parameters

Parameter	Type	Required	Description
`update_id`	string	Yes	The ID of the queued post to delete. Use 'Get queued posts' to find it.

Response

{
  "status": "success"
}

List the posts waiting to be published in a profile's queue.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	The ID of the Buffer profile (a connected social account) whose queue you want to see. Use 'List connected profiles' to find it.
`count`	number	No	Optional. Maximum number of posts to return, from 1 to 100. Defaults to 10.

Response

{
  "status": "success",
  "updates": []
}

List the social media profiles connected to your Buffer account, each with the ID needed by the other actions.

Response

{
  "profiles": [
    {
      "id": "5a1b2c3d4e5f6g7h",
      "service": "twitter",
      "username": "acme_corp"
    }
  ],
  "status": "success"
}

Publish a post to a Buffer profile right away, skipping the queue.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	The ID of the Buffer profile (a connected social account) to post to. Use 'List connected profiles' to find it.
`text`	string	Yes	The text of the post to publish.

Response

{
  "status": "success",
  "update": {
    "id": "5f8d9e1a2b3c4d5e",
    "status": "sent"
  }
}