Skip to content

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_workspaces

Permissions: 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_organizations

Permissions: 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_playlists

Permissions: 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_playlists

Permissions: workspace:read, posts:update

workspace_id · Required
string
channel_id · Required
string
post_id · Required
string
List Publishing TargetsRead only

Lists connected social channels and email/newsletter targets for a Postly workspace. Returns publishing target identifiers and metadata.

postly.list_social_accounts

Permissions: workspace:read, social_accounts:list

workspace_id · Required
Postly workspace ID.
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_sources

Permissions: 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_analytics

Permissions: 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_analytics

Permissions: 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_campaigns

Permissions: 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_campaign

Permissions: 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_posts

Permissions: 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_report

Permissions: 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_emails

Permissions: 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_email

Permissions: 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_analytics

Permissions: 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_connections

Permissions: 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_audience

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_followup

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_email

Permissions: 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_calendar

Permissions: 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_reports

Permissions: 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_capacity

Permissions: 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_overview

Permissions: 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_templates

Permissions: 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_template

Permissions: 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_template

Permissions: 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_audiences

Permissions: 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_audience

Permissions: 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_audience

Permissions: 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_membership

Permissions: 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_contacts

Permissions: 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_contact

Permissions: 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_contact

Permissions: 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_contact

Permissions: 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_import

Permissions: 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_import

Permissions: 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_import

Permissions: 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_imports

Permissions: 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_import

Permissions: 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_import

Permissions: 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_import

Permissions: 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_import

Permissions: 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_accounts

Permissions: 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_overview

Permissions: 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_ads

Permissions: 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_ads

Permissions: 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_campaigns

Permissions: 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_operations

Permissions: 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_ad

Permissions: 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_ad

Permissions: 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_targets

Permissions: 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_schema

Permissions: 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_post

Permissions: 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_media

Permissions: 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_batch

Permissions: 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_media

Permissions: 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_posts

Permissions: 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_activity

Permissions: 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_posts

Permissions: 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_status

Permissions: posts:status:read

post_id · Required
Postly post ID.
Get PostRead only

Retrieves sanitized details for a specific Postly post.

postly.get_post

Permissions: 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_post

Permissions: 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_post

Permissions: 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_post

Permissions: 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_move

Permissions: 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_channels

Permissions: 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_limits

Permissions: 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_limits

Permissions: 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_workspace

Permissions: 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_workspace

Permissions: 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_workspace

Permissions: 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_member

Permissions: members:invite

workspace_id · Required
string
email · Required
string
role · Required
string · OWNER, ADMIN, EDITOR
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.