Schedule and manage ContentStudio posts, approvals, campaigns, labels, categories, media, automations, the social inbox and analytics across workspaces.
Explore 265 workflow actions for ContentStudio, including account permissions and operation limits.
176 read actions89 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Abandon bulk automation
Write
Throws away everything in the batch that is still pending, so nothing further from this file is ever scheduled.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Act on bulk automation rows
Write
Approves the named rows - which is what schedules them - or deletes them.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add comment
Write
Create a new comment or internal note on a post.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add evergreen posts
Write
Appends one or more posts to the automation's recycling pool in a single atomic write, so concurrent callers cannot overwrite each other - safe to drive from a webhook or a.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Approval action
Write
Approve or reject a single post that is under review with an optional comment.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Archive media
Write
Archiving hides media from the default library listing without deleting it - the safe alternative to deletion for media attached to posts that have not published yet.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Attach bulk automation row campaign
Write
Puts pending rows in a campaign (folder), before they are approved.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Attach bulk automation row labels
Write
Sets the labels on pending rows, before they are approved.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Bluesky analytics audience growth
Read
Daily follower totals assembled from the snapshots ContentStudio retained.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics capabilities
Read
Machine-readable statement of what this platform can answer.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics engagement
Read
Engagement earned by the posts PUBLISHED on each day, measured at the last sync - not engagement that occurred on that day.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics hashtags
Read
Top hashtags from richtext tag facets and the record's explicit tags.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics posts per days
Read
How many posts were published on each weekday.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics publishing behaviour
Read
Posting volume and engagement over time, plus a rollup broken down by media type (text, image, gallery, video, link, record, other) with a total row.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics single post
Read
One authored post by its record key (rkey - the last segment of the at:// uri).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics sorted top posts
Read
Same payload and sort options as top-posts with a larger default page size, for the sortable posts table.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics summary
Read
Authored-post totals for the period plus the current profile counters.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Bluesky analytics top posts
Read
Highest-performing authored posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Campaign label analytics breakdown
Read
Splits the same scope as the summary endpoint into one row per campaign and one per label, so each can be compared against the others and against its own previous period.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Campaign label analytics insights breakdown
Read
The same three universally-reported metrics as the breakdown endpoint, but as a daily series rather than a period total - this is what backs the trend graphs.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Campaign label analytics posts
Read
The top limit posts overall (or within platforms), server-sorted.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Campaign label analytics summary
Read
total_engagement_rate_per_impression and the per-post engagement_rate are percentages (engagement / impressions * 100) on every platform.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Campaign label analytics top posts
Read
Same payload and response as the posts endpoint, except limit is ignored: this always returns 5 posts per selected network, merged and globally ordered by sort_by.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Create analytics report schedule
Write
Sets a report to build automatically.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create approval workflow
Write
Create a multi-level approval workflow with up to 5 levels.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create campaign
Write
Create a new campaign (folder) in the specified workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create competitor report
Write
There is no maximum number of competitors per report, and competitors are not metered individually.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create content category
Write
Create a new content category in the specified workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create content category slot
Write
Create one weekly posting slot.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create evergreen automation
Write
Creates an evergreen automation that recycles a pool of posts on a repeating schedule.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create label
Write
Create a new label in the specified workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create media folder
Write
Creates a folder in the workspace content library.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create post
Write
Create a new social media post with simplified payload structure.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create RSS automation
Write
Creates an RSS feed automation that posts new feed items to the selected accounts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create workspace
Write
Create a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete analytics report
Write
Delete a report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete analytics report schedule
Write
Stops the recurring report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete approval workflow
Write
Delete an approval workflow.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete campaign
Write
Permanently delete a campaign (folder) from the workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete competitor report
Write
Delete a saved competitor report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete content category
Write
Permanently delete a content category.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete content category slot
Write
Remove one weekly posting slot from a category.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete evergreen automation
Write
Permanently deletes the automation AND the posts it has scheduled.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete label
Write
Permanently delete a label from the workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete media
Write
Irreversible.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete media folder
Write
Irreversible and cascading.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete post
Write
Delete a specific social media post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete RSS automation
Write
Permanently deletes the automation AND the posts it has scheduled.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete team member
Write
Remove a member from a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete workspace
Write
Delete a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete workspace report
Write
Delete a cross-workspace report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Duplicate approval workflow
Write
Create a copy of an approval workflow, named (Copy).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Facebook analytics audience growth
Read
Facebook fan / follower growth over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics audience location
Read
Country and city breakdown of the page's followers.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics engagement
Read
Facebook page engagements over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics get top posts
Read
Facebook top posts with media_type filter.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics impressions
Read
Facebook page impressions over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics overview top posts
Read
Facebook top posts (overview widget).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics publishing behaviour
Read
Facebook engagement by impression type over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics reels
Read
Facebook Reels performance over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics single post
Read
Get a single Facebook post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics summary
Read
Facebook summary KPIs - current vs previous period.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Facebook analytics video insights
Read
Facebook video view time and plays over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch approval cascade job
Read
Poll the progress of a cascade dispatched by an approval-workflow update (confirmed=true) or a force delete.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch approval workflow
Read
Retrieve one approval workflow, including drafts, plus its runtime in-flight metrics.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch approval workflows
Read
Retrieve the workspace's published (non-draft) multi-level approval workflows.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch campaigns
Read
Retrieve paginated list of campaigns (folders) for a specific workspace, sorted alphabetically by name.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch comments
Read
Retrieve a paginated list of comments for a specific post.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch content categories
Read
Retrieve list of content categories for a specific workspace with resolved social account information.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch content category
Read
Retrieve one content category with its resolved social accounts AND its full weekly posting schedule, so a caller does not need a second request to understand when the category.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch content category next slot
Read
Answer when a post queued into this category right now would publish.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch content category slots
Read
Retrieve every weekly posting slot on a content category, ordered by period then hour.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch labels
Read
Retrieve paginated list of labels for a specific workspace, sorted alphabetically by name.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch media folders
Read
Returns every media-library folder in the workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Fetch posts
Read
Retrieve a paginated list of social media posts for a specific workspace with filtering options.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Flag media as brand asset
Write
Marks a media item as a brand asset so it feeds AI generation for the workspace's brand profile, exactly as flagging it from the Brand Knowledge tab does.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Generate analytics report
Write
Queues a report and returns its id immediately - the file is NOT ready when this call returns.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Generate workspace report
Write
Asynchronous, like every report: returns 202 and a report id.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get account analytics preferences
Read
Returns the stored preferences for a connected account.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get bulk automation status
Read
Progress of a queued bulk file.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get competitor report
Read
Read one saved competitor report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get evergreen automation
Read
Get an evergreen automation.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get me
Read
Retrieve information about the currently authenticated user.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get media storage
Read
Returns the media storage limit, current usage and remaining space for the workspace, so an integration can check for room before uploading instead of discovering a full library.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get post
Read
Retrieve a single social media post by its ID for a specific workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get RSS automation
Read
Get an RSS automation.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get RSS automation history
Read
What each feed pull did - how many new items it found and how many posts it created, or that it found nothing.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get team member social accounts
Read
List the social accounts a team member may use.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get team members
Read
Retrieve a paginated list of team members for a specific workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get workspace limits
Read
Read every metered entitlement for a workspace with what has been used, what the plan allows, and whether it applies - the same figures the billing screen shows for the same.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Get workspace settings
Read
Read a workspace's settings.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google ads analytics accounts
Read
The starting point for every other Google Ads endpoint: it returns the account_id they all require, along with the account's currency.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google ads analytics campaigns
Read
Paginated with limit/offset.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google ads analytics performance over time
Read
Ask for several metrics at once with metrics=spend,clicks,conversions and they arrive under series, keyed by metric name - one request, one query, however many metrics.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google ads analytics summary
Read
Spend, impressions, clicks, CTR, average CPC and conversions for the requested range, each alongside the equivalent prior range and the absolute and percentage change.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics actions
Read
GMB customer actions (clicks, calls, directions) over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics impressions
Read
GMB impressions breakdown by channel and device over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics media activity
Read
GMB media (photo/video) activity over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics publishing behavior
Read
GMB posts published over time and topic-type breakdown.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics reviews
Read
GMB reviews - ratings, distribution, and daily activity.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics search keywords
Read
GMB top search keywords that surfaced the listing.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics single post
Read
Get a single GMB post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics summary
Read
GMB summary KPIs - current vs previous period.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Google Business Profile analytics top posts
Read
GMB top-performing posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox add note
Write
Add an internal note.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox bookmark message
Write
Star a message (idempotent).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox conversation messages
Read
List messages in a conversation.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox delete comment
Write
Delete a comment.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox delete message
Write
Delete a message (soft).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox delete review reply
Write
Delete a review reply.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox element add tags
Write
Attach tags to an element.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox element contact
Read
Read an element's contact profile.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox element mark read
Write
Mark an element read (idempotent).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox element remove tag
Write
Detach a tag from an element.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox element update contact
Write
Update an element's contact profile.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox elements bulk update
Write
Bulk element state change (done / pending / archive / assign).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox elements search
Read
Search inbox elements.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox elements summary
Read
Inbox counts per bucket.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox hide comment
Write
Hide a comment (idempotent).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox like comment
Write
Like a comment (idempotent, Facebook).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox post comments
Read
List a post's comments (threaded).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox review reply
Write
Add or replace a review reply (upsert).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox tag create
Write
Create a tag.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox tag update
Write
Rename or recolour a tag.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox tags delete
Write
Delete tags (bulk).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox tags index
Read
List the workspace's inbox tags.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Inbox tags merge
Write
Merge tags into a new one.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox unbookmark message
Write
Unstar a message (idempotent).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox unhide comment
Write
Unhide a comment (idempotent).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Inbox unlike comment
Write
Unlike a comment (idempotent, Facebook).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Instagram analytics active users
Read
Instagram active users by hour and day of week.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics audience growth
Read
Instagram follower growth over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics country city
Read
Instagram reports top cities and top countries as two separate lists with nothing connecting them, so the country each city sits in is derived from the city label.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics demographics age
Read
Instagram audience age / gender breakdown.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics engagement
Read
Instagram post engagement over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics get top posts
Read
Instagram top posts with hashtag filter.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics hashtags
Read
Instagram top hashtags by engagement.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics impressions
Read
Instagram post impressions over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics publishing behaviour
Read
Instagram post engagement by media type over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics reels performance
Read
Instagram Reels engagement and watch time over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics single post
Read
Get a single Instagram post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics stories performance
Read
Instagram stories impressions, reach, and interactions over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics summary
Read
eng_rate is engagement as a percentage of post views (engagement / views * 100), matching engagement_rate on the overview summary endpoint.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Instagram analytics top posts
Read
Instagram top-performing posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics audience growth
Read
LinkedIn follower growth over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics followers demographics
Read
LinkedIn follower demographics by industry, country, and other dimensions.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics get top posts
Read
LinkedIn top posts with hashtag and media type filter.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics hashtags
Read
engagements / post_engagement: Engagement counts reactions, comments, reposts and post clicks - the same components LinkedIn uses for post_engagement_rate, so counts and rates.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics page views
Read
LinkedIn page views over time (desktop vs mobile).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics posts per days
Read
LinkedIn post count distribution by day of week.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics publishing behaviour
Read
engagements: Engagement counts reactions, comments, reposts and post clicks - the same components LinkedIn uses for post_engagement_rate, so counts and rates agree.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics single post
Read
Get a single LinkedIn post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics summary
Read
post_engagement / total_engagement: Engagement counts reactions, comments, reposts and post clicks - the same components LinkedIn uses for post_engagement_rate, so counts and.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Linkedin analytics top posts
Read
post_engagement: Engagement counts reactions, comments, reposts and post clicks - the same components LinkedIn uses for post_engagement_rate, so counts and rates agree.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List analytics report options
Read
The report types available and the sections each one can contain.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List analytics report schedules
Read
List a workspace's report schedules.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List analytics reports
Read
List a workspace's generated reports.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List bulk automation rows
Read
The posts built from the uploaded file, awaiting review.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List bulk automations
Read
List bulk uploads.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List competitor reports
Read
List a workspace's saved competitor reports.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List connect platforms
Read
Returns supported platforms, their connection method, required fields, and the endpoint to use for each connection flow.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List evergreen automations
Read
List evergreen automations.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List facebook text backgrounds
Read
Returns the full list of Facebook colored-background preset IDs accepted by facebook_options.facebook_background_id on POST /api/v1/workspaces/{workspace_id}/posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List media
Read
Retrieve a paginated list of media assets for a workspace with filtering, search, and sort options.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List RSS automation posts
Read
The posts this automation produced.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List RSS automations
Read
Paginated list of the workspace's RSS automations.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List social accounts
Read
List the workspace's connected social accounts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
List workspaces
Read
List the user's workspaces.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Meta ads analytics accounts
Read
The starting point for every other Meta Ads endpoint: it returns the account_id they all require, along with the account's currency.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Meta ads analytics ad sets
Read
Pass campaign_id to drill into one campaign's ad sets; omit it for every ad set in the account.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Meta ads analytics campaigns
Read
Paginated with limit/offset.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Meta ads analytics performance over time
Read
Ask for several metrics at once with metrics=spend,impressions,clicks and they arrive under series, keyed by metric name - one request, one query, however many metrics.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Meta ads analytics summary
Read
Spend, reach, impressions, clicks, CPM, CPC and CTR for the requested range, each alongside the equivalent prior range and the absolute and percentage change.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Move media
Write
Moves the given media into a folder.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Pause publishing
Write
Pause publishing for a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Pinterest analytics engagement trend
Read
Pinterest cumulative engagement trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics engagement trend daily
Read
Pinterest daily-delta engagement trend.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics follower trend
Read
Pinterest cumulative follower trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics follower trend daily
Read
Pinterest daily-delta follower trend.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics impressions trend
Read
Pinterest cumulative impressions trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics impressions trend daily
Read
Pinterest daily-delta impressions trend.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics pin performance
Read
Pinterest pin performance metrics over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics pin posting
Read
Pinterest cumulative pin posting activity over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics pin posting daily
Read
Pinterest daily-delta pin posting activity.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics pin rollup
Read
Pinterest pin performance rollup - current vs previous period.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics single pin
Read
Get a single Pinterest pin by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics summary
Read
engagement_rate is a percentage (pin clicks + outbound clicks + saves, over impressions * 100).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pinterest analytics top pins
Read
Pinterest top-performing and least-performing pins.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Pull RSS automation history
Write
Runs the automation's feed pull immediately instead of waiting for its pull_frequency, which is how a feed is backfilled.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove account
Write
Disconnect (remove) a connected social account from the workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove default approval workflow
Write
Demote the workspace default, leaving the workspace with no default workflow until another is promoted.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Resume publishing
Write
Resume publishing for a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Retry analytics report
Write
Retry a failed report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Run analytics report schedule now
Write
Builds and sends this schedule's report immediately, exactly as its next scheduled run would - same report, same recipients.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Scheduling optimal times
Read
Analyse historical performance of the workspace's connected accounts and return the best times to publish, both pooled across accounts (global) and per account (individual).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Search competitors
Read
Search a platform for an account to track as a competitor.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Set account analytics preference
Write
Sets a single key.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set analytics report schedule state
Write
A schedule auto-pauses after max_attempts consecutive failures - read active, paused_reason and consecutive_failures to see whether that has happened.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set default approval workflow
Write
Promote a workflow to the workspace default.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set evergreen automation status
Write
Sets whether the automation is active.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Set RSS automation status
Write
Sets whether the automation is active.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Shuffle content category posts
Write
Randomly reassign the execution times already held by this category's upcoming posts among those same posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Threads analytics activity
Read
What happened on each day ACROSS THE WHOLE ACCOUNT: profile views, likes, replies, reposts, quotes and link clicks.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics audience growth
Read
Daily follower totals assembled from the snapshots ContentStudio retained.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics audience location
Read
The same point-in-time breakdown as demographics, defaulting to the geographic dimensions instead of age and gender.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics capabilities
Read
The authoritative, machine-readable list of which sections this platform serves and which metrics it cannot supply, each with a reason.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics demographics
Read
A POINT-IN-TIME breakdown of the audience, not a range aggregate.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics engagement
Read
Engagement earned by the posts PUBLISHED on each day, measured at the last sync - not engagement that occurred on that day.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics hashtags
Read
Free-text hashtags parsed from the post text, ranked by engagement.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics posts per days
Read
How many posts were published on each weekday, bucketed in the requested timezone rather than UTC - 'what day did this go out' only means anything in the poster's own clock.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics posts per hours
Read
A 24-element array indexed by hour, 00:00 to 23:00, bucketed in the requested timezone.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics publishing behaviour
Read
The same daily series as engagement, plus a roll-up per media type and a total row.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics single post
Read
Looked up by identity: the post is resolved by post_id, so one published outside the dashboard window is still openable and the range never filters it out.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics sorted top posts
Read
The same rows as top-posts with a larger default page size (15) and an offset for paging.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics summary
Read
Post totals for the period alongside the account-level totals for the same days.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics top posts
Read
Posts ranked by the requested metric, defaulting to total engagement.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Threads analytics topic tags
Read
Threads topic tags ranked by engagement.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics engagement trend
Read
TikTok daily engagement trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics follower trend
Read
TikTok follower and views trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics publishing behaviour
Read
TikTok daily post volume and engagement breakdown over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics single post
Read
Get a single TikTok post by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics sorted top posts
Read
TikTok posts sorted by a configurable metric.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics summary
Read
avg_engagement_rate is a percentage (engagement / views * 100).
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Tiktok analytics top posts
Read
TikTok top and least performing posts.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics credits used
Read
Twitter API credits usage for the workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics engagement impression
Read
Twitter engagement and impression trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics followers trend
Read
Twitter follower trend over time.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics single tweet
Read
Get a single Twitter/X tweet by ID.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics summary
Read
Twitter summary KPIs - current vs previous period.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Twitter analytics top tweets
Read
Twitter top-performing tweets.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Unflag media as brand asset
Write
Clears the brand asset flag so the item no longer feeds AI generation.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update analytics report schedule
Write
Update a report schedule.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update approval workflow
Write
Partially update an approval workflow - fields that are not provided keep their current values.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update campaign
Write
Update a campaign's name and/or color.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update competitor report
Write
Update a saved competitor report.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update content category
Write
Partially update a content category.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update content category slot
Write
Partially update a slot - anything you omit keeps its current value.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update label
Write
Update a label's name and/or color.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update media folder
Write
Renames a media-library folder.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update media note
Write
Writes a free-text note on a media item.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update post
Write
Update a post that has NOT been published yet.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update RSS automation
Write
Changes an existing automation's feed or settings.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update team member
Write
Update a member's role and permissions.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update team member social accounts
Write
Grant or revoke the social accounts a team member may use, in one call.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update workspace
Write
Update a workspace.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
A repeated request may repeat the external action. Review the previous result before retrying a write.
Validate RSS feed URL
Read
Fetches the feed and reports whether it is readable, without creating anything.
Permissions and limits
Account permissions
A ContentStudio API key with access to the workspace
Marketing ยท CONNECTION
