How Buffer's GraphQL API Works

Module 2 · Section 3 of 7

How Buffer’s GraphQL API Works

Every request goes to https://api.bufferapp.com/graphql. You send a POST with a JSON body containing your query (or mutation) and any variables.

To queue a post, you use the createPost mutation. The key fields are:

• channelId — the ID of the connected channel you’re posting to
• text — the post content
• scheduledAt — optional ISO timestamp; if omitted, Buffer adds it to the queue

To find your channel IDs, query the channels field on the current user:

query {
  currentUser {
    channels {
      id
      name
      service
    }
  }
}

Run that once, save the IDs, and you’re set. They don’t change.