What can your agent do with Postly?
Find the action you need, see its inputs and understand what it changes. This directory reads the deployed MCP service and refreshes every five minutes.
For example, create a client workspace, invite their editor, and prepare a channel connection link from your CRM. The client authorizes their social account before you schedule content.
Requires Postly API access. Your account permissions, workspace access, plan limits and provider rules apply. Existing purchases retain their eligibility. A listed action is not permission to run it.
87 actions
Craft a Postly QueryRead only
Turns a user-written Postly question into a safe, explicit plan of existing MCP tools and identifies any missing context. Use this first for free-form requests; then call the planned tools. It never runs raw database or SQL queries.
postly.craft_query- query · Required
- The user's own natural-language question or requested outcome.
- workspace_id
- Optional known Postly workspace ID.
- post_id
- Optional known Postly post ID.
- platform
- Optional analytics platform.
- channel_id
- Optional analytics channel/source ID.
- relative_range
- Optional date phrase such as today, this_week, or last_30_days.
List WorkspacesRead only
Lists Postly workspaces available to the authenticated connection, optionally filtered by organization. Returns workspace identifiers and metadata.
postly.list_workspacesPermissions: workspace:list
- organization_id
- Optional Postly organization ID to filter by.
List OrganizationsRead only
Lists Postly organizations available to the authenticated connection. Returns organization identifiers and metadata for workspace selection.
postly.list_organizationsPermissions: workspace:list
List YouTube PlaylistsRead only
Lists one page of the selected connected YouTube channel playlists. Follow next_page_token until absent. Use the returned IDs in optional YouTube settings.playlist_ids.
postly.list_youtube_playlistsPermissions: workspace:read, social_accounts:list
- workspace_id · Required
- string
- channel_id · Required
- string
- page_token
- string
Retry YouTube Playlist AssignmentMakes changes
Checks playlist membership and retries definite failed additions for an already uploaded video. Never uploads a video or resends an uncertain addition. Requires explicit user authorization to retry.
postly.retry_youtube_playlistsPermissions: workspace:read, posts:update
- workspace_id · Required
- string
- channel_id · Required
- string
- post_id · Required
- string
List Analytics SourcesRead only
Lists connected accounts, pages, profiles, locations, and channels that support analytics for one workspace or every accessible workspace. Returns sources grouped by workspace.
postly.list_analytics_sourcesPermissions: workspace:list, workspace:read, analytics:read
- workspace_id
- Optional Postly workspace ID. Omit to scan all accessible workspaces.
- organization_id
- Optional organization ID to limit the workspace scan.
Get Account AnalyticsRead only
Fetches analytics for a connected Postly source such as a social account, page, profile, location, or channel. Returns metrics for the requested source and date range.
postly.get_account_analyticsPermissions: workspace:read, analytics:read
- workspace_id · Required
- Postly workspace ID.
- platform · Required
- Analytics platform identifier returned by postly.list_analytics_sources, such as instagram, facebook, linkedin, pinterest, youtube, googleMyBusiness, google_my_business, or x.
- channel_id · Required
- Analytics source channel_id returned by postly.list_analytics_sources.
- since
- Optional ISO-8601 start date/time for platforms that support ranges.
- until
- Optional ISO-8601 end date/time for platforms that support ranges.
Get Post AnalyticsRead only
Fetches analytics for a published Postly post on a supported platform. Returns metrics for the requested post and analytics source.
postly.get_post_analyticsPermissions: workspace:read, posts:read, analytics:read
- workspace_id · Required
- Postly workspace ID.
- platform · Required
- Analytics platform identifier returned by postly.list_analytics_sources, such as instagram, facebook, linkedin, pinterest, youtube, googleMyBusiness, google_my_business, or x.
- channel_id · Required
- Analytics source channel_id returned by postly.list_analytics_sources.
- post_id · Required
- Postly post ID.
List CampaignsRead only
Lists Postly campaigns in a workspace, newest first. Filter by status or by a name prefix or CAM- ID. Returns campaign IDs, names, objectives, status, dates, and targets. Requires campaigns.read.
postly.list_campaignsPermissions: workspace:read, campaigns:read
- workspace_id · Required
- Postly workspace ID.
- status
- Optional status filter. Defaults to all. · all, draft, planned, active, paused, completed, archived
- search
- Optional campaign name prefix or CAM- ID.
- before
- Optional campaign ID cursor. Pass the last campaign ID to load older campaigns.
- limit
- Optional page size. Defaults to 20.
Get CampaignRead only
Fetches one Postly campaign, including its brief, objective, audience, schedule, status, and targets. Requires campaigns.read.
postly.get_campaignPermissions: workspace:read, campaigns:read
- workspace_id · Required
- Postly workspace ID.
- campaign_id · Required
- Postly campaign ID from postly.list_campaigns.
List Campaign PostsRead only
Lists posts linked to a Postly campaign, newest first, with their status and targets. Use status published or failed to review outcomes. Requires campaigns.read and posts.read.
postly.list_campaign_postsPermissions: workspace:read, campaigns:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- campaign_id · Required
- Postly campaign ID from postly.list_campaigns.
- status
- Optional filter: all, published, failed, calendar, or a Postly post status. Defaults to all.
- before
- Optional post ID cursor. Pass the last post ID to load older posts.
- limit
- Optional page size. Defaults to 20.
Get Campaign ReportRead only
Fetches the performance report for a Postly campaign: planned, scheduled, published, and failed content plus engagement where available. Optionally limit it to a period of 1 to 366 days. Requires campaigns.read.
postly.get_campaign_reportPermissions: workspace:read, campaigns:read
- workspace_id · Required
- Postly workspace ID.
- campaign_id · Required
- Postly campaign ID from postly.list_campaigns.
- from
- Optional ISO 8601 start of the report period. Provide with until.
- until
- Optional ISO 8601 end of the report period. Provide with from.
list emailsRead only
list emails in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.list_emailsPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
get emailRead only
get email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.get_emailPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email analyticsRead only
email analytics in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_analyticsPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email connectionsRead only
email connections in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_connectionsPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email audienceRead only
email audience in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_audiencePermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
create emailMakes changes
create email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.create_emailPermissions: workspace:read, drafts:create
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
update emailMakes changes
update email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.update_emailPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
publish emailPermanent change
publish email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.publish_emailPermissions: workspace:read, posts:publish
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
schedule emailPermanent change
schedule email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.schedule_emailPermissions: workspace:read, posts:schedule
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
pause emailMakes changes
pause email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.pause_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
resume emailMakes changes
resume email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.resume_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
review emailRead only
review email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.review_emailPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
approve emailMakes changes
approve email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.approve_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
reject emailMakes changes
reject email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.reject_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
duplicate emailMakes changes
duplicate email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.duplicate_emailPermissions: workspace:read, drafts:create
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
create email followupMakes changes
create email followup in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.create_email_followupPermissions: workspace:read, drafts:create
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
archive emailMakes changes
archive email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.archive_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
restore emailMakes changes
restore email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.restore_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
rename emailMakes changes
rename email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.rename_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
move emailMakes changes
move email in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.move_emailPermissions: workspace:read, posts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email calendarRead only
email calendar in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_calendarPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
list email reportsRead only
list email reports in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.list_email_reportsPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email capacityRead only
email capacity in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_capacityPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
email overviewRead only
email overview in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.email_overviewPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
list email templatesRead only
list email templates in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.list_email_templatesPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
get email templateRead only
get email template in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.get_email_templatePermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
save email templateMakes changes
save email template in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.save_email_templatePermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
list email audiencesRead only
list email audiences in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.list_email_audiencesPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
save email audienceMakes changes
save email audience in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.save_email_audiencePermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
archive email audienceMakes changes
archive email audience in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.archive_email_audiencePermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
update email audience membershipMakes changes
update email audience membership in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.update_email_audience_membershipPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
import email contactsMakes changes
import email contacts in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.import_email_contactsPermissions: workspace:read, drafts:create
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
update email contactMakes changes
update email contact in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.update_email_contactPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
unsubscribe email contactPermanent change
unsubscribe email contact in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.unsubscribe_email_contactPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
delete email contactPermanent change
delete email contact in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.delete_email_contactPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
begin email audience importMakes changes
begin email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.begin_email_audience_importPermissions: workspace:read, drafts:create
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
upload email audience importMakes changes
upload email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.upload_email_audience_importPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
finish email audience importMakes changes
finish email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.finish_email_audience_importPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
list email audience importsRead only
list email audience imports in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.list_email_audience_importsPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
get email audience importRead only
get email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.get_email_audience_importPermissions: workspace:read, posts:read
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
pause email audience importMakes changes
pause email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.pause_email_audience_importPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
resume email audience importMakes changes
resume email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.resume_email_audience_importPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
cancel email audience importPermanent change
cancel email audience import in Postly Email. Uses the workspace audience, connected sending accounts and SmartFlow. Publishing requires the Email add-on, consent and workspace approvals. Acceptance does not confirm inbox delivery.
postly.cancel_email_audience_importPermissions: workspace:read, drafts:update
- workspace_id · Required
- Postly workspace ID.
- parameters
- Email fields for this action. Use id for existing emails; save_campaign requires name, subject, html and explicit audience_all or audience_list. Scheduling requires an ISO-8601 send_at with UTC offset.
List Ad AccountsRead only
Lists the paid ads networks and ad accounts connected to a Postly workspace, such as Google Ads and Meta Ads, with each account ID, name, currency, and whether it is selected for reporting. Use provider:account_id as the account key for other ads tools. Requires ads.read.
postly.list_ad_accountsPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
Get Ads OverviewRead only
Fetches paid ads performance for one connected ad account: spend, impressions, clicks, conversions, CTR, CPC, CPM, cost per result, and ROAS, with a per-campaign breakdown. Use a period of 1 to 90 days, or all_time where the network supports it. Requires ads.read.
postly.get_ads_overviewPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
- account · Required
- Ad account key as provider:account_id, for example google:1234567890.
- from
- Start date as YYYY-MM-DD. Required unless all_time.
- until
- End date as YYYY-MM-DD, at most 90 days after from. Required unless all_time.
- all_time
- Use lifetime totals where the network supports them.
- campaign_id
- Optional native ad campaign ID to focus the overview on.
List AdsRead only
Lists individual ads with their performance for a period, across all connected ad accounts or one account or network. Each ad includes key and snapshot_id for postly.compare_ads. Page with offset and next_offset, then next_account when several accounts are listed. Requires ads.read.
postly.list_adsPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
- from
- Start date as YYYY-MM-DD. Required unless all_time.
- until
- End date as YYYY-MM-DD, at most 90 days after from. Required unless all_time.
- all_time
- Use lifetime totals where the network supports them.
- account
- Optional account key (provider:account_id). Omit to list every connected account.
- network
- Optional ads network such as google or meta. Ignored when account is set.
- search
- Optional text to match the ad, campaign, or ID.
- status
- Optional native status filter such as ACTIVE or PAUSED.
- offset
- integer
- account_index
- Optional next_account value from a previous page.
Compare AdsRead only
Compares 2 to 20 ads from postly.list_ads on one metric and explains which performed best and why. Pass each ad as its key and snapshot_id. Requires ads.read.
postly.compare_adsPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
- ads · Required
- array
- metric · Required
- string · cpc, cost_per_conversion, ctr, cpm, roas, conversions, clicks, spend
List Ad CampaignsRead only
Lists the native campaigns in a connected ad account with their status, budget, and dates. Pass next as cursor to load more. Requires ads.read.
postly.list_ad_campaignsPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
- provider · Required
- Ads network from postly.list_ad_accounts, such as google or meta.
- account_id · Required
- Native ad account ID from postly.list_ad_accounts.
- cursor
- string
List Ad OperationsRead only
Lists the 30 most recent ad creations and changes made through Postly for an ad account, with their status and result. Use it to check an operation from postly.apply_ad. Requires ads.read.
postly.list_ad_operationsPermissions: workspace:read, ads:read
- workspace_id · Required
- Postly workspace ID.
- provider · Required
- Ads network from postly.list_ad_accounts, such as google or meta.
- account_id · Required
- Native ad account ID from postly.list_ad_accounts.
Prepare AdMakes changes
Validates a new ad campaign or a change to an existing one and saves it as a review that expires in 15 minutes. Nothing is published and no money is spent. Show the returned summary (action, budget, currency, countries, destination) to the user and get explicit confirmation before calling postly.apply_ad. Only workspace Owners and Admins can create or change ads with AI agents. Meta ad creation requires a connection with ads management access. Requires ads.write.
postly.prepare_adPermissions: workspace:read, ads:write
- workspace_id · Required
- Postly workspace ID.
- provider · Required
- Ads network from postly.list_ad_accounts, such as google or meta.
- account_id · Required
- Native ad account ID from postly.list_ad_accounts.
- kind · Required
- create for a new campaign, change for an existing campaign, ad group, or ad. · create, change
- draft · Required
- Create (Google Search): name, format search, url (public HTTPS), daily_budget and max_cpc in the account currency, headlines (3-15, up to 30 characters each), descriptions (2-4, up to 90 characters), keywords (1-30), countries as ISO codes, optional start_date and end_date as YYYY-MM-DD, launch_status PAUSED (default) or ACTIVE, and non_restricted true only after the user confirms the ad is not political, housing, employment, credit, or another restricted category. Display, Performance Max, and Demand Gen also need business_name, long_headline, and Postly media IDs in media_id, square_media_id, and logo_media_id. Change: entity campaign, group, or ad; campaign_id; resource_id for a group or ad; change status (with status ACTIVE or PAUSED), rename (new_name), budget (daily_budget), schedule (start, end), bid (max_cpc), creative, targeting, or delete. Validation errors explain any missing field.
Apply AdPermanent change
Publishes a reviewed ad campaign or change from postly.prepare_ad to the ad network. This can spend money. Call only after the user explicitly confirms that exact summary. Repeating the call returns the same operation instead of creating a duplicate. If the result needs attention, check the native ads account and postly.list_ad_operations before trying again. Only workspace Owners and Admins can create or change ads with AI agents. Requires ads.write.
postly.apply_adPermissions: workspace:read, ads:write
- workspace_id · Required
- Postly workspace ID.
- provider · Required
- Ads network from postly.list_ad_accounts, such as google or meta.
- account_id · Required
- Native ad account ID from postly.list_ad_accounts.
- operation_id · Required
- The id returned by postly.prepare_ad.
Resolve Publishing TargetsRead only
Resolves publishing targets by platform, organization, workspace, or name before a post is created or scheduled. Returns matching channels and workspace context.
postly.resolve_publishing_targetsPermissions: workspace:list, workspace:read, social_accounts:list
- organization_id
- Optional organization ID to search within.
- workspace_id
- Optional workspace ID to search within.
- platform
- Optional platform identifier such as telegram, x, linkedin, instagram, facebook, threads, or bluesky.
- query
- Optional channel/workspace/organization name fragment to match.
- limit
- integer
Get Channel SchemaRead only
Returns platform rules, character and media limits, required settings, safe defaults, and capture requirements for a supported Postly publishing channel. Use it before creating or scheduling content when the channel requirements are not already known.
postly.get_channel_schemaPermissions: social_accounts:read
- platform · Required
- Platform identifier such as x, linkedin, instagram, telegram, facebook, threads, bluesky, pinterest, youtube, tiktok, or google_my_business.
Validate PostRead only
Checks proposed post text, media, platform settings, schedules, and targets against Postly and platform-specific requirements. Returns validation status, errors, warnings, platform readiness, and applicable limits.
postly.validate_postPermissions: workspace:read, social_accounts:read
- custom_replies
- Shared first comment or follow-up sequence for supported selected platforms. Text and links only. Platform custom replies replace shared replies. Omit on update to preserve; [] clears shared replies.
- custom_reply_modes
- Per-platform reply selection: shared, custom, or off. Omit to preserve existing behavior. Custom settings replace rather than append.
- workspace_id · Required
- Postly workspace ID.
- text
- Post text or caption to validate.
- target_platforms
- Optional platform names, email/newsletter, provider names, or channel IDs. Use "all" or omit to validate against all connected workspace publishing targets.
- email_subject
- Required when validating a post for email/newsletter targets.
- one_off_schedule
- object
- recurring_schedule
- object
- media
- Optional media objects that will be attached to the post.
- platform_posts
- Optional platform-specific overrides. Use postly.get_channel_schema for the selected platform before supplying settings.
List MediaRead only
Lists durable stored media, or recovers one upload by idempotency_key. Recovery distinguishes processing, completed, and unknown. Respect retry_after_seconds; use media only when storage confirms completion. Requires media.read.
postly.list_mediaPermissions: media:read
- idempotency_key
- Recover a specific upload using its returned key instead of listing files. An unknown result may still be in progress; retry uploads only with this same key.
- offset
- Number of stored files to skip.
- limit
- Maximum number of files to return.
Upload Media BatchMakes changes
Uploads up to 50 files with bounded concurrency and a 30-second overall deadline. Returns completed, processing, failed, not_started, or unknown for every item with its stable idempotency key. Unknown uploads may still complete; reconcile stored media or retry with the same key.
postly.upload_media_batchPermissions: media:upload
- workspace_id
- Destination Media Library workspace ID. Omit to use the oldest available writable workspace within this connection. Check media_library in the result for its workspace_id and registration status.
- media_uploads · Required
- array
Upload MediaMakes changes
Imports media into Postly storage independently of a post mutation. Accepts a client-provided file reference, URL, data URL, or base64 payload. Returns a durable Postly media object only when complete; a 202 processing result requires a later list_media check with its idempotency_key before creating or scheduling a post.
postly.upload_mediaPermissions: media:upload
- workspace_id
- Destination Media Library workspace ID. Omit to use the oldest available writable workspace within this connection. Check media_library in the result for its workspace_id and registration status.
- file
- Client-provided file reference for an attached, selected, or generated file.
- url
- Public or temporary URL to import into Postly storage when no file reference is available.
- data
- Base64 content or a data URL for agents that can provide bytes instead of a URL.
- file_name
- Optional file name. Required when using data/base64 without a file reference.
- type
- Optional MIME type such as image/png, video/mp4, or application/pdf.
- alt_text
- Optional alt text to carry forward into the returned Postly media object.
- idempotency_key
- Optional stable key for safely retrying the same upload. Postly derives one automatically for file references and URLs.
List Scheduled PostsRead only
Lists scheduled posts for a requested workspace, date, relative date window, or explicit time range. Returns the resolved window, counts, and matching post summaries.
postly.list_scheduled_postsPermissions: workspace:list, workspace:read, posts:read
- workspace_id
- Optional workspace ID. Omit to search accessible workspaces.
- organization_id
- Optional organization ID. Use this to limit the search before choosing a workspace.
- relative_range
- Natural date window. Use "tomorrow" for requests like "How many posts do I have lined up for tomorrow?" Defaults to next_7_days when no date or range is provided. · today, yesterday, tomorrow, next_24_hours, next_7_days, next_30_days, this_week, next_week, upcoming
- date
- Optional exact local date in YYYY-MM-DD format. The timezone argument determines the local day.
- scheduled_from
- Optional inclusive ISO-8601 start boundary. Must be used with scheduled_until.
- scheduled_until
- Optional exclusive ISO-8601 end boundary. Must be used with scheduled_from.
- timezone
- Optional IANA timezone for relative_range or date, for example Africa/Lagos or America/New_York. Defaults to the account timezone or UTC.
- skip
- integer
- limit
- integer
Get Publishing ActivityRead only
Returns publishing activity for a requested date or time range, with actual published delivery counts separated from queued and processing posts.
postly.get_publishing_activityPermissions: workspace:list, workspace:read, posts:read
- workspace_id
- Optional workspace ID. Omit to search accessible workspaces.
- organization_id
- Optional organization ID. Use this to limit the search before choosing a workspace.
- relative_range
- Natural date window. Use "today" or "yesterday" when a user asks how many posts were published on a local day. Defaults to next_7_days when no date or range is provided. · today, yesterday, tomorrow, next_24_hours, next_7_days, next_30_days, this_week, next_week, upcoming
- date
- Optional exact local date in YYYY-MM-DD format. The timezone argument determines the local day.
- scheduled_from
- Optional inclusive ISO-8601 start boundary. Must be used with scheduled_until.
- scheduled_until
- Optional exclusive ISO-8601 end boundary. Must be used with scheduled_from.
- timezone
- Optional IANA timezone for relative_range or date, for example Africa/Lagos or America/New_York. Defaults to the account timezone or UTC.
- skip
- integer
- limit
- integer
- activity_from
- Optional inclusive ISO-8601 activity start boundary. Must be used with activity_until.
- activity_until
- Optional exclusive ISO-8601 activity end boundary. Must be used with activity_from.
- published_from
- Alias for activity_from when the user asks about published posts.
- published_until
- Alias for activity_until when the user asks about published posts.
List PostsRead only
Lists recent Postly posts, optionally filtered by workspace and status. Returns sanitized post summaries for the authenticated connection.
postly.list_postsPermissions: posts:read
- workspace_id
- Optional Postly workspace ID.
- status
- Optional status such as draft, scheduled, queued, processing, pending_approval, or unknown.
- skip
- integer
- limit
- integer
Get Post StatusRead only
Retrieves publishing status, delivery counts, and failure_results for a post. Allowance failures retain the reset time and recovery message. Queued does not mean published; never resend an uncertain post.
postly.get_post_statusPermissions: posts:status:read
- post_id · Required
- Postly post ID.
Get PostRead only
Retrieves sanitized details for a specific Postly post.
postly.get_postPermissions: posts:read
- post_id · Required
- Postly post ID.
Create PostPermanent change
Creates, queues, or schedules a Postly post for social or email/newsletter targets. Accepts content, target selections, schedules, platform settings, and client-provided media references for import in the same action. Returns the mutation result, platform readiness, blockers, and any required follow-up data.
postly.create_postPermissions: posts:create, posts:schedule
- campaign_id
- Optional campaign ID in the same workspace. Campaign content approval and workspace post approval still apply. Omit to preserve the association on update.
- workspace_id · Required
- Postly workspace ID.
- workspace_ids
- Optional list of Postly workspace IDs. Use instead of workspace_id when creating the same post in multiple workspaces.
- text
- string
- custom_replies
- Shared first comment or follow-up sequence for supported selected platforms. Text and links only. Platform custom replies replace shared replies. Omit on update to preserve; [] clears shared replies.
- custom_reply_modes
- Per-platform reply selection: shared, custom, or off. Omit to preserve existing behavior. Custom settings replace rather than append.
- first_comment
- string
- use_publishing_presets
- Apply the workspace publishing preset. Defaults to true. Set false only when the user explicitly wants platform defaults instead.
- publishing_preset_id
- Optional workspace publishing preset ID. When omitted, Postly uses the preset named Default or the oldest saved preset.
- publishing_preset
- Optional workspace publishing preset name. Use instead of publishing_preset_id.
- target_platforms
- Social platform names, email/newsletter, provider names, or channel IDs. Use "all" to target all connected publishing targets in the workspace. Email targets require email_subject and text.
- email_subject
- Subject line required when targeting email/newsletter channels.
- email_preview_text
- Optional short preview text for email/newsletter delivery.
- email_targeting
- Optional advanced email targeting map keyed by email integration ID. Each value is a resource ID, a resource object with id, or an array of those. Usually not needed when using email channel_id values returned by postly.list_social_accounts.
- audience_group
- Audience group ID or IDs. Do not combine with target_platforms.
- media
- Already-hosted media objects for the post. Use the media_file fields instead for attached, generated, selected, local, base64, or temporary media that Postly must import during the create or update action.
- media_file
- Client-provided file reference or temporary URL for the first attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_2
- Client-provided file reference or temporary URL for the number 2 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_3
- Client-provided file reference or temporary URL for the number 3 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_4
- Client-provided file reference or temporary URL for the number 4 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_5
- Client-provided file reference or temporary URL for the number 5 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_6
- Client-provided file reference or temporary URL for the number 6 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_7
- Client-provided file reference or temporary URL for the number 7 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_8
- Client-provided file reference or temporary URL for the number 8 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_9
- Client-provided file reference or temporary URL for the number 9 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_10
- Client-provided file reference or temporary URL for the number 10 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_alt_texts
- Optional alt text values aligned with media_file, media_file_2, and later media_file fields.
- media_uploads
- Optional inline upload specs for agents that can supply public URLs, temporary URLs, base64, or data URLs. Postly imports these assets and appends them to media before creating or updating the post.
- one_off_schedule
- object
- recurring_schedule
- object
- platform_posts
- Platform-specific overrides. Each item should include identifier and settings. Call postly.get_channel_schema for each selected platform to see required settings and simple capture guidance.
- labels
- array
Update PostPermanent change
Updates editable content, media, labels, social or email/newsletter targets, and schedules for an existing Postly post. Accepts client-provided media references for import in the same action and returns the mutation result, platform readiness, blockers, and any required follow-up data.
postly.update_postPermissions: posts:update, posts:schedule
- campaign_id
- Optional campaign ID in the same workspace. Campaign content approval and workspace post approval still apply. Omit to preserve the association on update.
- post_id · Required
- Postly post ID.
- text
- string
- custom_replies
- Shared first comment or follow-up sequence for supported selected platforms. Text and links only. Platform custom replies replace shared replies. Omit on update to preserve; [] clears shared replies.
- custom_reply_modes
- Per-platform reply selection: shared, custom, or off. Omit to preserve existing behavior. Custom settings replace rather than append.
- first_comment
- string
- use_publishing_presets
- Apply the workspace publishing preset. Defaults to true. Set false only when the user explicitly wants platform defaults instead.
- publishing_preset_id
- Optional workspace publishing preset ID. When omitted, Postly uses the preset named Default or the oldest saved preset.
- publishing_preset
- Optional workspace publishing preset name. Use instead of publishing_preset_id.
- target_platforms
- Social platform names, email/newsletter, provider names, or channel IDs. Use "all" to target all connected publishing targets in the workspace. Email targets require email_subject and text.
- email_subject
- Subject line required when targeting email/newsletter channels.
- email_preview_text
- Optional short preview text for email/newsletter delivery.
- email_targeting
- Optional advanced email targeting map keyed by email integration ID. Each value is a resource ID, a resource object with id, or an array of those. Usually not needed when using email channel_id values returned by postly.list_social_accounts.
- audience_group
- Audience group ID or IDs. Do not combine with target_platforms.
- media
- Already-hosted media objects for the post. Use the media_file fields instead for attached, generated, selected, local, base64, or temporary media that Postly must import during the create or update action.
- media_file
- Client-provided file reference or temporary URL for the first attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_2
- Client-provided file reference or temporary URL for the number 2 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_3
- Client-provided file reference or temporary URL for the number 3 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_4
- Client-provided file reference or temporary URL for the number 4 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_5
- Client-provided file reference or temporary URL for the number 5 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_6
- Client-provided file reference or temporary URL for the number 6 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_7
- Client-provided file reference or temporary URL for the number 7 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_8
- Client-provided file reference or temporary URL for the number 8 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_9
- Client-provided file reference or temporary URL for the number 9 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_file_10
- Client-provided file reference or temporary URL for the number 10 attached, selected, or generated media file. Postly imports it during the create or update action.
- media_alt_texts
- Optional alt text values aligned with media_file, media_file_2, and later media_file fields.
- media_uploads
- Optional inline upload specs for agents that can supply public URLs, temporary URLs, base64, or data URLs. Postly imports these assets and appends them to media before creating or updating the post.
- one_off_schedule
- object
- recurring_schedule
- object
- platform_posts
- Platform-specific overrides. Each item should include identifier and settings. Call postly.get_channel_schema for each selected platform to see required settings and simple capture guidance.
- labels
- array
Delete PostPermanent change
Permanently removes only the post in Postly. Does not delete or recall live content on any social platform. For live removal, use Delete on Platforms in the dashboard where supported before deleting the post, or remove content directly on the platform. Requires a Postly post ID, not a provider post ID.
postly.delete_postPermissions: posts:delete
- post_id · Required
- Postly post ID.
Preview a channel moveRead only
Review selected publishing channels moving between workspaces owned by the same account. Use platform_id from the channel parent_id and channel_ids from list_social_accounts. Requires write access to both workspaces. Returns a review_token without moving anything. Posts and analytics stay in the source; unfinished publishing and CRM allocations block the move.
postly.preview_channel_movePermissions: channels:connect, workspace:manage
- workspace_id · Required
- string
- destination_workspace_id · Required
- string
- platform_id · Required
- The selected publishing channel parent_id from list_social_accounts, not the provider name.
- channel_ids · Required
- array
- request_id · Required
- Caller-generated unique request ID. Preserve it for preview, confirmation and every retry of this exact move.
Move reviewed publishing channelsPermanent change
After explicit user approval of the exact channels and destination, confirm a previewed move using its unchanged request_id and review_token with confirm:true. Moves connections only; posts and analytics stay behind. Retry an uncertain result with the same inputs, never disconnect/reconnect to resolve it. Refresh channel discovery in both workspaces afterward.
postly.move_channelsPermissions: channels:connect, workspace:manage
- workspace_id · Required
- string
- destination_workspace_id · Required
- string
- platform_id · Required
- The selected publishing channel parent_id from list_social_accounts, not the provider name.
- channel_ids · Required
- array
- request_id · Required
- Caller-generated unique request ID. Preserve it for preview, confirmation and every retry of this exact move.
- review_token · Required
- Exact token returned by preview after reviewing the selected channels and destination.
- confirm · Required
- boolean
Read workspace usage limitsRead only
Read optional owner-set workspace limits and monthly usage. Limits do not grant plan access or reserve shared capacity.
postly.get_workspace_usage_limitsPermissions: workspace:read
- workspace_id · Required
- string
Update workspace usage limitsMakes changes
Replace optional limits for one owned workspace after explicit user approval. Omitted or null values remove caps; zero stops new consumption. Existing content is kept. Only the account owner can change limits.
postly.update_workspace_usage_limitsPermissions: workspace:manage
- workspace_id · Required
- string
- limits · Required
- object
- confirm · Required
- boolean
Create a workspaceMakes changes
Create a named workspace under an existing organization owned by your account. Requires all-workspace write access and the workspace:manage OAuth scope. Existing plan limits apply. An uncertain response must be checked with list_workspaces before retrying.
postly.create_workspacePermissions: workspace:manage
- organization_id · Required
- string
- name · Required
- string
Rename a workspaceMakes changes
Change only the workspace name. The organization and its other workspaces are unchanged.
postly.rename_workspacePermissions: workspace:manage
- workspace_id · Required
- string
- name · Required
- string
Delete a workspacePermanent change
Permanently delete one owned workspace and its associated data using the same deletion service as Postly. Obtain explicit approval and repeat its ID in confirm_workspace_id. Never infer deletion from a cleanup request.
postly.delete_workspacePermissions: workspace:manage
- workspace_id · Required
- string
- confirm_workspace_id · Required
- Repeat the exact workspace ID only after explicit approval of permanent deletion.
Invite a workspace memberMakes changes
Send an invitation to a specific email with an explicit role: OWNER, ADMIN or EDITOR. Requires user approval (confirm:true), workspace write access and team capacity. Never retry an uncertain send automatically.
postly.invite_workspace_memberPermissions: members:invite
- workspace_id · Required
- string
- email · Required
- string
- role · Required
- string · OWNER, ADMIN, EDITOR
- confirm · Required
- boolean
Prepare a channel connectionMakes changes
Create a single-use connection handoff link valid for 10 minutes. After user approval (confirm:true), give the link to the intended person privately. The recipient needs no Postly account or Postly sign-in. They approve access with the social provider, signing in there only if needed; this tool does not connect a channel by itself. A workspace invitation is optional. Wait for a confirmed connection before publishing. Some providers require destination selection afterward.
postly.create_channel_connection_linkPermissions: channels:connect
- workspace_id · Required
- string
- platform · Required
- string · facebook, instagram, linkedin, googleMyBusiness, youtube, blogger, pinterest, tiktok, wordpress, threads, discord, slack, whatsapp, x
- confirm · Required
- boolean
Client onboarding questions
Can I create, rename or delete a workspace through the API or MCP?
Yes. Create a workspace under an organization you own, rename it, or explicitly confirm its permanent deletion. Workspace creation requires an API key with write access to all workspaces. Existing plan limits still apply.
Can I invite a client and connect their social accounts?
You can send a workspace invitation with an explicit role and create a private, single-use channel connection link. Supported platforms are Facebook, Instagram, Threads, LinkedIn, Google Business Profile, YouTube, Pinterest, TikTok, WhatsApp, X, Blogger, WordPress.com, Discord and Slack. The last four support API/MCP link creation only, without a dashboard Share link button. Other platforms use Channels setup. The link expires after 10 minutes. The recipient needs no Postly account or Postly sign-in. They approve access with the social provider, signing in there only if needed, and select publishing destinations where required; generating a link does not mean the channel is connected.
Will my existing AI connection gain these permissions automatically?
No. OAuth connections need approval for workspace:manage, members:invite or channels:connect, depending on the action. API key access and organization and workspace restrictions still apply. Reconnect with the permissions you need.
How do I avoid duplicates when a request times out?
Check the current workspace or invitation state before trying again. Do not automatically repeat invitations or destructive actions after an uncertain response. Keep returned identifiers in your CRM workflow so later steps use the same workspace.