Unique identifier for the account

Primary email address for the account

Backup email address for account recovery

URL to the account's avatar image

Date the account was created in the Core DB. For older customers, it's possible a Publish account existed in the Publish DB for this customer before this date

The account-level timezone - this is used as a default input for streaks, posting plans, and new channel channel connections.

The account name, different from the organization name

The accounts preferences

The connected apps for the account

The type of the annotation

The indices of the annotation in the text

The content of the annotation. Annotations can sometimes be different from the actual text content. E.g., Mastodon mentions have 'text: @buffer', but includes the server name in the content, 'content: @buffer@threads.net'

The text representation of the annotation, eg '@buffer'

The URL the annotation points to

The unique identifier of the author.

The email address of the author.

The avatar URL of the author.

Indicates whether the author is a deleted.

The name of the author. Null if the user has not yet set a name.

The instance of bluesky of the channel

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

The list of threaded posts (not paginated)

The number of threaded posts

Link attachment

The ID of the channel Source: mapper from channel collection - channel._id Defined in: both proposals

The allowed actions for the current user Source: field resolver Defined in: new proposal

Scopes requested for a given channel - empty array if we don't have them tracked Source: mapper from channel collection - channel.credentials.scopes Defined in: current implementation

The avatar URL of the channel Source: mapper from channel collection - channel.avatar Defined in: both proposals

The creation date of the channel Source: mapper from channel collection - channel.createdAt Defined in: both proposals

Formatted name of the channel service and type: e.g. 'Twitter Profile' or 'Facebook Page' Source: mapper from channel collection - channel.service and channel.type Defined in: current implementation

The display name of the channel - nullable (reason?) Source: mapper from channel collection - channel.displayName Defined in: current implementation

Indicates if the channel is properly connected to Buffer Source: mapper from channel collection - channel.credentials.invalid Defined in: both proposals

Indicates if the channel is locked - Locked channels can't be used for posting. A channel can be locked when the organization downgrades and reduces the channel quantity of their plan. Source: mapper from channel collection - channel.isLocked Defined in: both proposals

Indicates if the channel was recently created (in less than 10 seconds). This is used to determine the redirect modal after channel authorization Source: mapper from channel collection - channel.createdAt comparison with current time Defined in: current implementation

Provides the posting slots for each day of the week Source: field resolver based on profiles collection - getPostingSchedule

Indicates is the queue is paused for the channel. A paused queue means schedules posts won't be published. Source: Field resolver - From profiles collection - profile.paused Defined in: new proposal

Indicates if trending topic suggestions should be shown in the composer. When false, users can still access trends via the trending icon button. Defaults to true for backward compatibility. Source: Field resolver - From profiles collection - profile.show_trending_topic_suggestions

Metadata or settings depending on the service type - such as the server URL for Mastodon or Location data for Facebook/GPB Source: Field resolver - From channel collection: channel.locationData + channel.serverURL | profile collection: profile.default_to_reminder Defined in: new proposal

The name of the channel - the handle name, username, etc. Source: mapper from channel collection - channel.name Defined in: both proposals

The organization ID of the channel Source: mapper from channel collection - channel.organizationId Defined in: both proposals

Products that support a given channel

Represents the social network Source: mapper from channel collection - channel.serviceType Defined in: both proposals

Represents the external ID of the channel on social network API Source: mapper from channel collection - channel.serviceId Defined in: both proposals

The timezone of the channel - Default if not set is Europe/London Source: field resolver based on profiles collection - timezone Defined in: both proposals

The type of the channel - Page, Profile, Business, Group, Account, etc. Source: mapper from channel collection - channel.type Defined in: both proposals

The last time the channel was updated Source: mapper from channel collection - channel.updatedAt Defined in: both proposals

Whether at least one member of the orginization who have access to this channel also has a user device registered for push notifications

The posting goal for the channel

The channel's URL on the social network (e.g. instagram.com/username or facebook.com/page) Source: field resolver Returns null if the channel is not supported

Link Shortening settings for the channel

Configuration of link shortening integration. Null if disabled.

If link shortening is enabled for the channel

The id of the connectedApp.

The id of the user that has granted access to the app.

The name of the connected app.

A brief description of the connected app.

The website URL of the connected app.

The date and time when the connected app was created.

The ID of the asset in the database

The type of the asset

The MIME type of the asset

URL to the file source

URL to the static thumbnail of the asset

Document specific metadata

Document fileSize in bytes

Number of pages in the document

URLs to the static thumbnails of the document pages

Metadata about the location of the business associated with the channel. Only available for Facebook and GPB

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

Link attachment

Title of Facebook reel

Facebook post's first comment

Title of the event

Start date of the event

End date of the event

Indicate whether the event has a start or end time.

Action button

Link to the action

Metadata about the location of the business associated with the channel. Only available for Facebook and GPB

Title of the offer

Start date of the offer

End date of the offer

Coupon code for the offer

Link to the offer

Terms and Conditions

The channel-specific type of the post, eg, post, story, reel for Instagram

Title if available in the given GBP post type: event and offer

Annotations representing entities in the text

Details of the metadata

Action button

Link to the action

Unique identifier for the idea

ID of the organization that owns this idea

The actual content and metadata of the idea

ID of the group this idea belongs to (if any)

Numerical position for ordering within a group

Unix timestamp of when the idea was created

Unix timestamp of when the idea was last modified

Title or headline of the idea

Main body text or description of the idea

List of media items attached to the idea

Tags used to categorize and organize the idea

Indicates whether AI tools were used in creating this idea

Services tagged by the user - this is typically used to annotate ideas with their target services

DateTime set by user associated with the idea - this often reflects a target publish date.

Unique identifier for the media in Buffer's upload system

Direct URL to access the media file

Alternative text description for accessibility

URL to a smaller version of the media for preview purposes

Type of media (e.g., image, video, gif)

File size in bytes

Source platform information for the media

Name of the media source platform (e.g., 'Unsplash', 'Giphy')

Unique identifier from the source platform

Name of the content creator/author

URL to the author's profile on the source platform

The affected idea

If true, the client should refresh the ideas list because other ideas might have been moved

The ID of the asset in the database

The type of the asset

The MIME type of the asset

URL to the file source

URL to the static thumbnail of the asset

Image specific metadata

Alternative text for accessibility

Image width in pixels

Image height in pixels

Is the image animated?

Animated thumbnail URL

User tags in the image

The id of this location

The name of this location

Indicates if we should default to reminder for Instagram Source: field resolver: profile.default_to_reminders

Instagram post's first comment

Shop Grid link for the post

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

Geolocation of the post

Indicates whether post should be shared to feed

Sticker fields for reminder-based publishing

Text for the Story or Reel

Placeholder text for the post's music

Placeholder text for the post's linked products

Placeholder text for the post's topics (Reels only)

Additional field for any other post content

Error message

Error message

URL that the link asset has been built from

Full URL that the link asset has been built from

Description for the scraped link

Thumbnails of media available in the link

Selected thumbnail for this link preview

Title for the link attachment

Property parsed from scopes indicating whether the client should show the LinkedIn analytics refresh banner

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

LinkedIn post's first comment

Link attachment

Domain of the link shortener - eg buff.ly, dub.co, or the user's custom domain.

Human readable string to describe the link shortening service.

Location of the business associated with the channel

Link to the map

Google Account Id of the business

The instance of mastodon of the channel

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

The list of threaded posts (not paginated)

The number of threaded posts

Spoiler text hiding the root text of this post

The total count of team members counting the org owner and team members from the Publish DB.

The unique identifier of the note.

The content of the note.

The type of the note.

The author of the note - null if the user is deleted or left the organization.

The date and time when the note was created.

The date and time when the note was last edited.

The allowed actions a user can perform on the note.

Error message

The ID of the organization.

The total number of channels connected to the organization.

The limits of the organization. Can be used to check if the organization has reached the limit of channels, members, etc.

The members of the organization. Can be used to check the total number of members in the organization. In the future, it might contain more information about the members.

The name of the organization.

The owner email of the organization.

The first cursor in the list. It can be used to fetch the previous page.

The last cursor in the list. It can be used to fetch the next page.

When set to true, it means there is a previous page available. Will always return false for now as we only support forward pagination.

When set to true, it means there is a next page available.

The ID of the board

The ID of the service

The board name

The board URL

The board description

The board avatar

The list of boards the user has on Pinterest

The channel-specific type of the post, eg, post, story, reel for Instagram

The title of the Pin

The Pin destination link

The board the Pin is saved to

Annotations representing entities in the text

ObjectId of the post

Is set when the Post is generated from an Idea

status

Indicates if the post is created from Buffer or the API

Scheduling type can be null if the post was created natively on the social network without using notification publishing or automatic publishing

Represents the user who created the post

Indicates whether time to publish was manually selected by the user

Date when the post was created

Date when the post was updated

Date when the post is scheduled to be published

Date when the post is published

Text content of the Post

The external URL of the post at the destination service

Metadata of the post which differs based on the social network/service @see post.metadata.graphql

channel ID (faster than resolving the channnel.id)

channel service (faster than resolving the channnel.service)

channel

tags - sorted by name in ascending order

notes

notificationStatus: notified or markedAsPublished

error

assets

Indicates what actions the current account can perform on the post

Indicates whether the post was shared via publish now action

Indicates the share mode of the post (e.g., addToQueue, shareNext, shareNow, customScheduled)

Post on which the action was successfully performed.

The target number of posts for this goal.

The number of posts that have been sent (published or ingested) for this goal.

The number of posts that are scheduled to be sent for this goal.

The current status of the posting goal.

The start date of the period for this posting goal.

The end date of the period for this posting goal.

Error message to display

Link to a help center article to help resolve the error

The original error from the publishing service (internal use only)

Represents the current post in the list.

Opaque cursor to be used in pagination to fetch from current node.

The list of posts that match the query.

Information to aid in pagination.

Hex color for tag e.g #F523F1

An error message from the REST API response that we proxied here

Link to our Help center from the REST API response

Error code from the REST API response - https://buffer.com/developers/api/errors

Retweet ID

Link to original tweet

Text of the original tweet

Date when the original tweet was created

User who created the original tweet

Thumbnails to media available in the link

Name of the user who created the original Tweet

Username of the user who created the original Tweet

Avatar of the user who created the original Tweet

The day of the week: mon, tue, wed, thu, fri, sat, sun

The times the channel is scheduled to post on the day: HH:MM

Indicates if this day is paused in the posting schedule.

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

Optional link in post

ObjectId of the tag

Hex color for tag e.g '#F523F1'

Name of the tag e.g 'Summer sales'

Locked tag cannot be assigned to new items in the UI. A Tag is locked after a customer downgrades and has more tags than the free plan limit allows

The text body content of the threaded post

Media assets of the threaded post

Link attachment for the threaded post

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

The list of threaded posts (not paginated)

The number of threaded posts

Link attachment

Topic associated with the post

LocationId associated with the post

Location name associated with the post

Indicates if we should default to reminder for Tiktok Source: field resolver: profile.default_to_reminders

The channel-specific type of the post, eg, post, story, reel for Instagram

Annotations representing entities in the text

The title of the TikTok post (for photo posts)

Indicates the type of subscription the user has on Twitter

The channel-specific type of the post, eg, post, story, reel for Instagram

The details of the tweet being retweeted

Annotations representing entities in the text

The list of threaded posts (not paginated)

The number of threaded posts

Error message

Error message

The handle of the user

The x coordinate of the user tag

The y coordinate of the user tag

The ID of the asset in the database

The type of the asset

The MIME type of the asset

URL to the file source

URL to the static thumbnail of the asset

Video specific metadata

Video duration in seconds

Video container format

Video codec

Video framerate

Video bitrate in kbps

Audio codec

Rotation degree

Whether the video needs to be transcoded before it can be broadcasted

Whether the video is currently being processed (transcoding in progress)

Video width in pixels

Video height in pixels

Video fileSize in bytes

Error message

The number of posts the channel has sent this week

The number of posts the channel has scheduled for this week

The weekly posting limit for the channel

Indicates if we should default to reminder for Youtube Source: field resolver: profile.default_to_reminders

The channel-specific type of the post, eg, post, story, reel for Youtube

Annotations representing entities in the text

Title of the Youtube post

Privacy setting for post

Post category

Video license

Indicates whether to notify subscribers on publish video

Indicates whether the video allows embedding

Indicates whether the video is suitable for kids

The content of the annotation, e.g. '107509875938399'

The indices of the annotation in the text, e.g. [6, 9] (from 6 to 9 characters in the text)

The text representation of the annotation, eg 'Buffer'

The URL the annotation points to, e.g. https://www.facebook.com/107509875938399

The id of the annotation, e.g. 1521226

The link of the annotation, e.g. https://www.linkedin.com/company/bufferapp

The entity of the annotation, e.g. urn:li:organization:1521226

The vanity name of the annotation, e.g. bufferapp

The localized name of the annotation, e.g. Buffer

The start of the annotation, e.g. 5

The length of the annotation, e.g. 6

Images to be attached to the post

Videos to be attached to the post

Documents to be attached to the post

Link to be attached to the post

The list of threaded posts (not paginated)

Link attachment

The ID of the channel to be retrieved

If not defined, it returns all channels Else, if true, it only returns locked channels if false, it only returns not locked channels

If not passed, it return all channels Else, it filters the channels based on what the product supports.

The Organization id to fetch channels for

A list of option filters - passing null means we don't want to filter

Organization ID that will own the idea

Content and metadata for the new idea

Call-to-action identifier for analytics tracking

Group placement (null for unassigned group)

Template ID used to create the idea

Is set when the Post is generated from an Idea

Is set when the Post is generated from a Draft

Scheduling type to indicate notification publishing or automatic publishing

Date when the post is scheduled to be published

Text content of the Post

Metadata of the post which differs based on the social network/service

Channel's Id for which we want to create the post

List of tag IDs

assets

How the post is being scheduled.

source where the composer was initiated from, used for tracking.

If this post was created with the help of AI

If true, saves the post as a draft instead of scheduling it. When saving as draft:

• Post status will be 'draft' instead of 'buffer'
• Posting limits are not checked
• The post will not be published until explicitly scheduled

Include results with dates equal to or after the specified date

Include results with dates equal to or before the specified date

Document URL

Document title

Document thumbnail URL

The channel-specific type of the post, eg, post, story, reel for Facebook

Annotations representing entities in the text

Link attachment

Facebook post's first comment

Title of the event

Start date of the event

End date of the event

Indicate whether the event has a start or end time.

Action button

Link to the action

Title of the offer

Start date of the offer

End date of the offer

Coupon code for the offer

Link to the offer

Terms and Conditions

The channel-specific type of the post, eg, post, offer, event for Google Business Profile

Title if available in the given GBP post type: event and offer

Details of the Offer metadata

Details of the Event metadata

Details of the Whats new metadata

Action button

Link to the action

Title or headline of the idea

Main body text or description

List of media items to attach

Tags to categorize the idea

Whether AI tools were used in creation

Services associated with the idea for targeting specific platforms

Target date for the idea, often used for planning publish schedules

Target group ID (null for unassigned group)

ID of idea to place after (null for top position)

The URL of the media

Alternative text for the media

Thumbnail URL for the media

The type of media (image, gif, video, link, document, unsupported). Note: 'video' is not supported via public API

The size of the media in bytes

Source information for the media

for unsplash only

URL to the file source

URL to the static thumbnail of the asset

Image specific metadata

Image width in pixels

Image height in pixels

Alternative text for accessibility

Animated thumbnail URL

User tags in the image

Image dimensions

The id of this location

The name of this location

The channel-specific type of the post, eg, post, story, reel for Instagram

Instagram post's first comment

Shop Grid link for the post

Geolocation of the post

Indicates whether post should be shared to feed

Sticker fields for reminder-based publishing

Text for the Story or Reel

Placeholder text for the post's music

Placeholder text for the post's linked products

Placeholder text for the post's topics (Reels only)

Additional field for any other post content

URL to the link

Title of the link

Description of the link

Thumbnail URL of the link

URL that the link asset has been built from

Annotations representing entities in the text

LinkedIn post's first comment

Link attachment

The list of threaded posts (not paginated)

Spoiler text hiding the root text of this post

The title of the Pin

The Pin destination link

The board ID of the Pin, can be obtained when fetching the channel details with the following query:

query GetChannelWithSubprofiles {
  channel(input: { id: "[CHANNEL_ID_HERE]" }) {
    metadata {
      ... on PinterestMetadata {
        boards {
          serviceId
        }
      }
    }
  }
}

The ID of the post to be retrieved

Metadata for Instagram post

Metadata for Facebook post

Metadata for LinkedIn post

Metadata for Twitter post

Metadata for Pinterest post

Metadata for Google Business Profile post

Metadata for Youtube post

Metadata for Mastodon post

Metadata for Start Page post

Metadata for Threads post

Metadata for Bluesky post

Metadata for TikTok post

When set, it will filter posts by channel

When set, it will return posts with createdAt or dueAt date after startDate

When set, it will return posts with createdAt or dueAt date before endDate

When set, it will filter posts by status

Filter posts by tags. Supports specific tags, untagged posts, or union of both.

When set, it will filter posts by tag

When set, it will filter posts by their scheduled posting date

When set, it will filter posts by the date they were created

The Organization id to fetch posts for

The filters to apply to the posts query

The sort to apply to the posts results

The field to sort by.

The direction to sort by.

Retweet ID

Optional link in post

Include results that have any of the specified tags (union/OR).

When true, include results that have no tags assigned. Can be combined with 'in' for union filtering. Defaults to false if not specified.

The text body content of the threaded post

Media assets of the threaded post

The type of the post

The list of threaded posts (not paginated)

Link attachment

Topic associated with the post

LocationId associated with the post

Location name associated with the post

The title of the TikTok post (for photo posts)

The details of the tweet being retweeted

The list of threaded posts (not paginated)

The handle of the user

The x coordinate of the user tag

The y coordinate of the user tag

URL to the file source

URL to the thumbnail of the video

Video specific metadata

Offset of the thumbnail chosen for the video, in ms

Video title

Title of the Youtube post

Privacy setting for post (default: public)

Youtube Category ID, one ID of this list: ID: 1 -> Film & Animation ID: 2 -> Autos & Vehicles ID: 10 -> Music ID: 15 -> Pets & Animals ID: 17 -> Sports ID: 19 -> Travel & Events ID: 20 -> Gaming ID: 22 -> People & Blogs ID: 23 -> Comedy ID: 24 -> Entertainment ID: 25 -> News & Politics ID: 26 -> Howto & Style ID: 27 -> Education ID: 28 -> Science & Technology ID: 29 -> Nonprofits & Activism

Video license (default: youtube)

Indicates whether to notify subscribers on publish video (default: true)

Indicates whether the video allows embedding (default: true)

Indicates whether the video is suitable for kids (default: false)