Buffer

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

Add a post to the publishing queue for a profile with an optional schedule.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	Profile identifier to publish to
`text`	string	Yes	Content of the post
`scheduled_at`	string	No	ISO8601 timestamp to schedule the post

Response

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

Remove a scheduled update from the Buffer queue.

Parameters

Parameter	Type	Required	Description
`update_id`	string	Yes	Identifier of the update to delete

Response

{
  "status": "success"
}

Fetch queued updates for a profile.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	Profile identifier to inspect
`count`	number	No	Maximum number of updates to fetch

Response

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

Retrieve the authenticated user's Buffer profiles.

Response

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

Immediately share a post to a Buffer profile.

Parameters

Parameter	Type	Required	Description
`profile_id`	string	Yes	Profile identifier to publish to
`text`	string	Yes	Content of the post

Response

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