Skip to navigation

Social publishing and reviews

Move from connected accounts to drafts, review, and publication.
View as Markdown

1. Choose your destination

Call social_getSocialMediaAccounts in the intended teamspace. Select the returned account IDs for the channels you want to use. Platform names alone are not account identifiers.

Prepare a LinkedIn and Instagram version of our launch announcement for the connected Acme accounts. Keep both as drafts.

2. Prepare channel-specific content

Read the brand kit, write the copy, and prepare any required media. Use persistent asset IDs where the tool expects media references. Check the current tool schema for each platform’s supported content and options; do not assume one payload works unchanged across all channels.

For LinkedIn document carousels, supply the PDF URL in additional.linkedin.document.url and send media: []. Use a fresh file_url from a ready PDF asset. The document field takes a URL, not an asset UUID.

Publish a blog article

WordPress and Shopify use the same social_createSocialMediaPost tool as other connected accounts. Discover the blog account ID first. Put the full article in message and the required title in the platform’s additional object. Keep the account attached when saving a draft: an accountless draft drops additional, including the article title.

For a self-hosted WordPress site with the Simplified WordPress plugin, use additional.wordpress.post. The body can be Markdown or HTML; the first media item becomes the featured image. Optional fields include slug, excerpt, categoryId, authorId, tagIds, and tags. status can be publish, draft, pending, or private; it requires plugin 1.0.14 or later. Omit status to use the site’s default.

{
"action": "draft",
"account_ids": ["WORDPRESS_ACCOUNT_ID"],
"message": "# Article heading\n\nFull article body...",
"media": [],
"additional": {
"wordpress": { "post": { "title": "Article title" } }
}
}

For Shopify, use additional.shopify.article. The body must be Markdown. Shopify accepts at most one featured photo and no video or auto-comments. Optional fields include blogId (a gid://shopify/Blog/... ID), excerpt, slug, tags, and author. Omit blogId for the store’s first blog. Set published: false to create a hidden article; Simplified’s planner still reports that post as published, so check its Shopify visibility separately.

{
"action": "draft",
"account_ids": ["SHOPIFY_ACCOUNT_ID"],
"message": "# Article heading\n\nFull article body...",
"media": [],
"comments": [],
"additional": {
"shopify": { "article": { "title": "Article title", "published": false } }
}
}

These examples save planner drafts. To publish, choose publish_now or schedule the post after reviewing the account, article, visibility, and media. publish_now runs asynchronously; use social_getSocialMediaPost with the returned ID to check the outcome.

3. Create and verify a draft

Use social_createSocialMediaPost with action: "draft". For example, these tool arguments create a text-only draft after you replace the account placeholder with a discovered ID:

{
"message": "Meet our new dashboard: a clearer view of your campaign results.",
"action": "draft",
"account_ids": ["ACCOUNT_ID_FROM_DISCOVERY"],
"media": []
}

Include your resolved space_id as well when targeting a teamspace. Save the response identifiers and retrieve the result through social_getSocialMediaDrafts. Use social_updateSocialMediaDraft for revisions to an existing draft.

Tags help organize drafts and posts. Discover them with social_listSocialMediaTags; create a missing tag with social_createSocialMediaTag before applying its returned identifier.

4. Collect review

Use social_createSocialMediaReviewBundle to group selected drafts for review. If your connection exposes social_addDraftsToSocialMediaReviewBundle, you can add more drafts to an existing bundle. Keep the bundle identifier and returned review link.

Put these three drafts into one review bundle and give me its review link. Leave the drafts unpublished.

Creating a review bundle is not the same as publishing its drafts. Share the returned link with the intended reviewers through your normal review process.

5. Schedule or queue

social_createSocialMediaPost supports draft, schedule, add_to_queue, and publish_now. Queueing uses the account’s publishing queue; publish_now sends immediately and asynchronously.

For a scheduled post, provide the target accounts and date in YYYY-MM-DD HH:MM format. Pass an IANA timezone when the time is in a specific zone; otherwise the workspace timezone applies. Updating an existing scheduled post supports separate date, time, and timezone fields through social_updateSocialMediaPost.

Verify the resulting status and scheduled time with social_getSocialMediaPosts.

A successful request does not by itself prove a platform has published the post. Report the returned state and any platform error, then recheck the post when necessary.

Manage existing content

Retrieve the resource before changing it. Use the draft update/delete tools for drafts and the post update/delete tools for posts. After a timeout, search existing drafts or posts before retrying creation to avoid duplicates.