API Status Get API Key

API Changelog

A running log of additions, changes, and deprecations to the Buffer GraphQL API.

June 9, 2026

Deprecated

Added

  • PostMetricType Type 'PostMetricType' was added
  • PostMetricType.reactions Enum value 'reactions' was added to enum 'PostMetricType'
  • PostMetricType.reactions Description 'How many people reacted to your post. Unified across networks: Instagram/Twitter `likes`, Mastodon `favorites`, etc. all map to this value.' was added to enum value 'PostMetricType.reactions'
  • PostMetricType.comments Enum value 'comments' was added to enum 'PostMetricType'
  • PostMetricType.comments Description 'The count of comments and replies on your post. Unified across networks (Threads `replies` maps here).' was added to enum value 'PostMetricType.comments'
  • PostMetricType.shares Enum value 'shares' was added to enum 'PostMetricType'
  • PostMetricType.shares Description 'How many times your post was shared or forwarded by others.' was added to enum value 'PostMetricType.shares'
  • PostMetricType.reposts Enum value 'reposts' was added to enum 'PostMetricType'
  • PostMetricType.reposts Description 'How many times your post was reposted by others. Twitter `retweets`, Mastodon `reblogs`, Threads `reposts` all normalize to this value.' was added to enum value 'PostMetricType.reposts'
  • PostMetricType.reach Enum value 'reach' was added to enum 'PostMetricType'
  • PostMetricType.reach Description 'The number of unique people who saw your post.' was added to enum value 'PostMetricType.reach'
  • PostMetricType.impressions Enum value 'impressions' was added to enum 'PostMetricType'
  • PostMetricType.impressions Description 'How many times your post was shown on screen. May include multiple views by the same person — useful for spotting how often the content gets surfaced.' was added to enum value 'PostMetricType.impressions'
  • PostMetricType.views Enum value 'views' was added to enum 'PostMetricType'
  • PostMetricType.views Description 'How many times your post was viewed. Used for video-style posts and on networks that report views distinctly from impressions.' was added to enum value 'PostMetricType.views'
  • PostMetricType.clicks Enum value 'clicks' was added to enum 'PostMetricType'
  • PostMetricType.clicks Description 'How many times people clicked on your post.' was added to enum value 'PostMetricType.clicks'
  • PostMetricType.engagementRate Enum value 'engagementRate' was added to enum 'PostMetricType'
  • PostMetricType.engagementRate Description 'The percentage of people who interacted with your post compared to how many saw it. Unit: percentage.' was added to enum value 'PostMetricType.engagementRate'
  • PostMetricType.saves Enum value 'saves' was added to enum 'PostMetricType'
  • PostMetricType.saves Description 'How many times people saved your post (Instagram, Pinterest). A strong signal that the content is worth revisiting.' was added to enum value 'PostMetricType.saves'
  • PostMetricType.follows Enum value 'follows' was added to enum 'PostMetricType'
  • PostMetricType.follows Description 'The number of new followers gained from this post (Instagram).' was added to enum value 'PostMetricType.follows'
  • PostMetricType.quotes Enum value 'quotes' was added to enum 'PostMetricType'
  • PostMetricType.quotes Description 'How many times your post was quoted (Threads).' was added to enum value 'PostMetricType.quotes'
  • PostMetricType.viewers Enum value 'viewers' was added to enum 'PostMetricType'
  • PostMetricType.viewers Description 'Unique viewer count for video-style posts (LinkedIn).' was added to enum value 'PostMetricType.viewers'
  • PostMetricType.totalTimeWatched Enum value 'totalTimeWatched' was added to enum 'PostMetricType'
  • PostMetricType.totalTimeWatched Description 'Total time watched, in minutes, for video-style posts (LinkedIn).' was added to enum value 'PostMetricType.totalTimeWatched'
  • PostMetricType.likes Enum value 'likes' was added to enum 'PostMetricType'
  • PostMetricType.likes Description 'The Like-reaction subcount on Facebook. Distinct from `reactions` (which is the total of all reaction types — Like, Love, Care, Haha, Wow, Sad, Angry); Facebook\'s Graph API reports them separately and we mirror that.' was added to enum value 'PostMetricType.likes'
  • PostMetricType.postCount Enum value 'postCount' was added to enum 'PostMetricType'
  • PostMetricType.postCount Description 'The count of posts included in an aggregated response. Only meaningful on aggregate endpoints — never emitted per-post.' was added to enum value 'PostMetricType.postCount'
  • PostMetricType.replies Enum value 'replies' was added to enum 'PostMetricType'
  • PostMetricType.favorites Enum value 'favorites' was added to enum 'PostMetricType'
  • PostMetricType.reblogs Enum value 'reblogs' was added to enum 'PostMetricType'
  • PostMetricType.retweets Enum value 'retweets' was added to enum 'PostMetricType'
  • PostMetricType.repins Enum value 'repins' was added to enum 'PostMetricType'
  • PostMetricType.link_clicks Enum value 'link_clicks' was added to enum 'PostMetricType'
  • PostMetricType.other Enum value 'other' was added to enum 'PostMetricType'
  • PostMetricUnit Type 'PostMetricUnit' was added
  • PostMetricUnit.count Enum value 'count' was added to enum 'PostMetricUnit'
  • PostMetricUnit.count Description 'An integer count (e.g. number of reactions, impressions, reach).' was added to enum value 'PostMetricUnit.count'
  • PostMetricUnit.percentage Enum value 'percentage' was added to enum 'PostMetricUnit'
  • PostMetricUnit.percentage Description 'A percentage value between 0 and 100 (e.g. engagement rate).' was added to enum value 'PostMetricUnit.percentage'
  • PostMetric Type 'PostMetric' was added
  • PostMetric.type Field 'type' was added to object type 'PostMetric'
  • PostMetric.name Field 'name' was added to object type 'PostMetric'
  • PostMetric.displayName Field 'displayName' was added to object type 'PostMetric'
  • PostMetric.description Field 'description' was added to object type 'PostMetric'
  • PostMetric.value Field 'value' was added to object type 'PostMetric'
  • PostMetric.nullableValue Field 'nullableValue' was added to object type 'PostMetric'
  • PostMetric.unit Field 'unit' was added to object type 'PostMetric'
  • Post.metrics ⚠️ Experimental Field 'metrics' was added to object type 'Post'
  • Post.metricsUpdatedAt Field 'metricsUpdatedAt' was added to object type 'Post'

June 9, 2026

Added

Removed

June 9, 2026

Added

Removed

May 19, 2026

Added

May 15, 2026

Added

May 12, 2026

Added

May 12, 2026

Added

  • AssetInput Type 'AssetInput' was added
  • AssetInput.image Input field 'image' of type 'ImageAssetInput' was added to input object type 'AssetInput'
  • AssetInput.video Input field 'video' of type 'VideoAssetInput' was added to input object type 'AssetInput'
  • AssetInput.document Input field 'document' of type 'DocumentAssetInput' was added to input object type 'AssetInput'
  • AssetInput.link Input field 'link' of type 'LinkAssetInput' was added to input object type 'AssetInput'
  • AssetInput.@oneOf Directive 'oneOf' was added to input object 'AssetInput'

Removed

Changed

May 6, 2026

Added

Changed

April 22, 2026

Added

  • EditPostInput Type 'EditPostInput' was added
  • EditPostInput.id Input field 'id' of type 'PostId!' was added to input object type 'EditPostInput'
  • EditPostInput.schedulingType Input field 'schedulingType' of type 'SchedulingType!' was added to input object type 'EditPostInput'
  • EditPostInput.dueAt Input field 'dueAt' of type 'DateTime' was added to input object type 'EditPostInput'
  • EditPostInput.text Input field 'text' of type 'String' was added to input object type 'EditPostInput'
  • EditPostInput.metadata Input field 'metadata' of type 'PostInputMetaData' was added to input object type 'EditPostInput'
  • EditPostInput.tagIds Input field 'tagIds' of type '[TagId!]' was added to input object type 'EditPostInput'
  • EditPostInput.assets Input field 'assets' of type 'AssetsInput' was added to input object type 'EditPostInput'
  • EditPostInput.mode Input field 'mode' of type 'ShareMode!' was added to input object type 'EditPostInput'
  • EditPostInput.aiAssisted Input field 'aiAssisted' of type 'Boolean' was added to input object type 'EditPostInput'
  • EditPostInput.saveToDraft Input field 'saveToDraft' of type 'Boolean' was added to input object type 'EditPostInput'
  • Mutation.editPost Field 'editPost' was added to object type 'Mutation'
  • Mutation.editPost.input Argument 'input: EditPostInput!' added to field 'Mutation.editPost'

April 9, 2026

Changed

  • CreatePostInput Description 'Create post\'s request input.' on type 'CreatePostInput' has changed to 'Create post\'s request input. Note: `assets.videos` and `metadata.{service}.linkAttachment` are mutually exclusive. If both are provided, the video is ignored.'

March 16, 2026

Added

February 19, 2026

Added

February 17, 2026

Deprecated

Added

  • TagComparator Type 'TagComparator' was added
  • TagComparator.in Input field 'in' of type '[TagId!]!' was added to input object type 'TagComparator'
  • TagComparator.isEmpty Input field 'isEmpty' of type 'Boolean!' with default value 'false' was added to input object type 'TagComparator'
  • PostsFiltersInput.tags Input field 'tags' of type 'TagComparator' was added to input object type 'PostsFiltersInput'

February 9, 2026

Removed

February 4, 2026

Removed

February 3, 2026

Added

  • Organization 'Organization' object implements 'AccountOrganization' interface

Changed

  • Account.organizations Field 'Account.organizations' changed type from '[AccountOrganization!]!' to '[Organization!]!'
  • AccountOrganization 'AccountOrganization' kind changed from 'ObjectTypeDefinition' to 'InterfaceTypeDefinition'
  • OrganizationFilterInput Description 'Allow retrieving a specific AccountOrganization' on type 'OrganizationFilterInput' has changed to 'Allow retrieving a specific Organization'

January 28, 2026

Added

Removed