[ Web Proxy ]
URL:
Viewing: https://developers.buffer.com/examples/../examples/../guides/../guides/ideas.html [Back]  [Original]

Ideas - Buffer API
Buffer API [Buffer API]
Search docs... K
API Status Get API Key
Core ConceptsIdeas

Ideas

Copy Page

Ideas let you capture content thoughts and plan ahead before scheduling to a specific channel.

Ideas vs. posts

The key difference:

  • Posts belong to a channel. They're assigned to a specific social media profile and have a scheduled time.
  • Ideas belong to an organization. They're not tied to any channel or schedule yet.

Think of ideas as your content backlog. When you're ready to publish, you create a post from an idea by assigning it to a channel.

Creating an idea

Use the createIdea mutation with your organization ID:

Copy Copied!
mutation {
  createIdea(input: {
    organizationId: "your_org_id",
    content: {
      title: "Blog post announcement",
      text: "We just published our guide to social media automation. Share it across all channels this week."
    }
  }) {
    ... on Idea {
      id
      content {
        title
        text
      }
    }
    ... on MutationError {
      message
    }
  }
}

The content object supports:

  • title - a short heading for the idea (optional)
  • text - the body content of the idea

See Create an Idea for a complete example.

Why ideas belong to organizations

Ideas are organization-level because they haven't been assigned to a platform yet. A single idea might eventually become:

  • A tweet on X
  • A carousel on Instagram
  • A post on LinkedIn

Since you haven't decided which channel (or channels) to use, the idea lives at the organization level where all your channels are.

When you're ready to publish, create a Post on the appropriate channel using the idea's content.

Next steps

Previous Posts & Scheduling Next Hosting Media
On this page
Ideas vs. posts Creating an idea Why ideas belong to organizations Next steps

Web Proxy Viewer  |  New URL  |  Original Page