Read from the server's own catalogue, so it matches what the server answers.
List social sets
list_social_setsReads onlyThe user's social sets: each is a group of connected social accounts with its own Hive profile (brand voice), time zone and weekly posting slots. Start here: most other tools take a social_set_id and account ids from this answer. Answers each set's id, name, time zone, brand profile, connected accounts (id, platform, name, handle, whether it's connected), default accounts for a new draft, posting slots, whether natural times are on and whether next_slot can be used.
Inputs
Takes no inputs.
List brand profiles
list_brand_profilesReads onlyThe user's brand profiles (Buzzmark calls them Hive profiles): what Buzzmark knows about each brand, its voice, tone, audience and products. Writing tools write in a brand profile's voice; pass its id as hive_profile_id, or leave it out to use the social set's own. Answers each profile's id and name with what Buzzmark knows about the brand, and the accounts its name is tagged as on each platform.
Inputs
Takes no inputs.
List campaigns
list_campaignsReads onlyList a brand's campaigns: name, description, first and last day. Use an id from here as campaign_id when saving or scheduling a post. A campaign is a named run of posts for one social set, such as a launch, that the user reads and reports on as one in Buzzmark. Answers each campaign's id, social set, name, description, first and last day on the set's clock, and the ids of the posts in it.
Inputs
social_set_idOptional- number. Only this social set's campaigns, id from list_social_sets. Leave out for every set.
List posts
list_postsReads onlyBuzzes in Buzzmark, newest first: drafts, scheduled, published or failed. Answers each post's id, status, scheduled time, social set, brand profile, account ids, how many parts it has and its text, cut to 400 characters; get_post gives the whole Buzz. Use the ids it answers with get_post, save_draft, schedule_post and the other post tools.
Inputs
statusOptional- one of "draft", "scheduled", "published", "failed", "all". Which posts: "draft", "scheduled", "published", "failed", or "all" (default). Default "all".
social_set_idOptional- number. Only this social set's posts, id from list_social_sets. Leave out for every set.
limitOptional- number, 1 to 50. How many posts, newest first. 1 to 50, default 20.
Get a post
get_postReads onlyOne Buzz in full: every part of a thread with its text and pictures, its first comment, the accounts it goes to, its social set and brand profile, its status and its scheduled time. Use it after list_posts, which cuts text to 400 characters, or to read a draft before changing it with save_draft. It carries no likes or other numbers: get_post_stats has those for published posts.
Inputs
post_idRequired- number. The Buzz's id, from list_posts or from save_draft's answer.
Write posts in the brand's voice
write_postsBuzz writes 1 to 5 new posts from an idea, in a Hive profile's voice, with Buzzmark's writing rules and its after-check. Every answer is kept in the user's Library in Buzzmark. Nothing is saved as a draft: pass the text you want to save_draft. Use it for posts that don't exist yet; to change a post that does, use rewrite_post, and to give a saved draft its own text for each platform, adapt_for_platforms.
Inputs
ideaRequired- text, up to 2,000 characters. What the posts are about, in the user's words.
hive_profile_idOptional- number. Brand profile whose voice writes the posts, id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set whose Hive profile writes the posts, when hive_profile_id is left out. Optional when the account has one set.
platformOptional- text. Buzzmark platform id (x, linkedin, instagram, threads, facebook, tiktok, bluesky, pinterest, google-business) to write for.
formatOptional- one of "post", "thread". "post" for single posts (default) or "thread" for threads. Default "post".
countOptional- number, 1 to 5. How many posts to write, 1 to 5, default 3.
with_picture_briefOptional- yes or no. Add a brief for a picture to each post, for create_image. Default false.
Save a draft
save_draftCreates a Buzz draft, or updates one (post_id). A draft stays a draft: nothing is posted or scheduled. Give text for one post, or thread for several. Says what a platform would refuse (length, a missing picture, a LinkedIn tag LinkedIn can't find) so it can be fixed before schedule_post. Tagging: on X, Threads, Instagram and TikTok write @handle. On LinkedIn write the profile or page link in brackets, @[https://www.linkedin.com/company/<slug>] or @[https://www.linkedin.com/in/<id>], and LinkedIn shows its own name for it; every other platform gets that name as plain text. On Facebook a mention stays plain text. A brand profile with accounts (list_brand_profiles shows them) needs none of that: write its name, and when the post is scheduled its first mention is tagged on each platform it has an account on. first_comment adds a comment posted under the post the moment it goes out, on LinkedIn, Instagram, Facebook and Threads: the place for a link or the hashtags, so the post itself stays clean. Send idempotency_key with a new draft when you might retry: the same key within 24 hours answers the draft the first call saved.
Inputs
post_idOptional- number. Update this draft instead of making a new one.
textOptional- text, up to 10,000 characters. The words of a single post. Use thread instead for several.
threadOptional- list of text, up to 25. A thread: one string per post. Replaces text.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile the draft is written for, id from list_brand_profiles. Default: the social set's own.
account_idsOptional- list of number, up to 20. Accounts it goes to, first one leading. Default: the set's default accounts.
first_commentOptional- text, up to 5,000 characters. A comment posted under the post right after it goes out, on LinkedIn, Instagram (not a story), Facebook and Threads; other platforms leave it out. At most 500 characters on Threads, 1,250 on LinkedIn, 2,200 on Instagram, 5,000 on Facebook. An empty string removes it; leave it out to keep the draft's comment as it is.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
idempotency_keyOptional- text, up to 200 characters. A key you make for this one call, such as a UUID. Send the same key again, unchanged, only when you retry after a timeout or a lost answer: within 24 hours the retry answers what the first call did instead of doing it twice. Never reuse a key for a different call.
Schedule a post
schedule_postSchedules a draft for a time, at the best time, or in the social set's next free posting slot. Never posts right away. A draft that goes to Pinterest needs pinterest.boards (from list_pinterest_boards), and takes a title and a link; Pinterest pins are scheduled one at a time here, never with schedule_posts. With "best_time", Buzzmark picks the soonest free hour when posts on these accounts do best, from numbers it keeps to itself (LinkedIn doesn't allow its numbers in AI apps), and answers the time it picked. Times are on the set's clock unless they carry an offset. When the set has natural times on (list_social_sets says), the post goes out a few minutes either way of the time named; the answer says the real time. When the person's role in their organization needs an approval first, the draft is sent for approval instead (sent_for_approval in the answer) and goes out once a teammate approves it. A draft that carries a carousel gets its PDF and slides made first, as when the owner sends it from Buzzmark; it goes to LinkedIn, Instagram and TikTok only. Buzzmark refuses what would hurt the account, and the refusal says which: two X accounts in one post (X bans the same words on several accounts), Recycle with an X account, words that already went to X in another post, more posts in a day than the platform takes from one account, or two posts on one account within a minute. A post already scheduled minutes ago with the same words, accounts and time is answered with that post (repeat in the answer), never scheduled twice. For several drafts at once, use schedule_posts.
Inputs
post_idRequired- number. The draft's id, from save_draft or list_posts.
whenRequired- text. "best_time" (Buzzmark picks the soonest free best time for these accounts), "next_slot", or a date and time: "2026-10-02T09:00" on the set's clock, or ISO 8601 with an offset.
account_idsOptional- list of number, up to 20. Default: the accounts saved on the draft, else the set's default accounts.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
pinterestOptional- object. Only for a draft that goes to Pinterest: its board, title and link.
idempotency_keyOptional- text, up to 200 characters. A key you make for this one call, such as a UUID. Send the same key again, unchanged, only when you retry after a timeout or a lost answer: within 24 hours the retry answers what the first call did instead of doing it twice. Never reuse a key for a different call.
Schedule several posts
schedule_postsSchedules up to 25 drafts in one go, each at its own time, at the best time or in the next free slot, for example the drafts create_weekly_content_plan saved (each one's date and time is its slot). Never posts right away. A draft that goes to Pinterest is reported and left out: Pinterest asks that each pin is chosen on its own, so schedule it with schedule_post. Before calling it, show the person every draft with its accounts and time, and call it once they agree. Each draft is checked on its own: one that can't go out is reported and the others are still scheduled. When the person's role needs an approval first, the drafts are sent for approval instead. Buzzmark refuses what would hurt the account, and the refusal says which: two X accounts in one post (X bans the same words on several accounts), Recycle with an X account, words that already went to X in another post, more posts in a day than the platform takes from one account, or two posts on one account within a minute. A post already scheduled minutes ago with the same words, accounts and time is answered with that post (repeat in the answer), never scheduled twice.
Inputs
postsRequired- list of object, up to 25. Each draft with its time (post_id, when, optional account_ids, optional campaign_id).
idempotency_keyOptional- text, up to 200 characters. A key you make for this one call, such as a UUID. Send the same key again, unchanged, only when you retry after a timeout or a lost answer: within 24 hours the retry answers what the first call did instead of doing it twice. Never reuse a key for a different call.
Move a scheduled post
reschedule_postMoves a scheduled post to a new date and time on the set's clock, kept exactly. Never posts right away. The words, pictures and accounts stay as they are. Answers the post's id, its new time and the set's time zone. To post at the best time or in the next free slot instead, take it back with unschedule_post and schedule it again.
Inputs
post_idRequired- number. The scheduled post's id, from list_posts with status "scheduled".
whenRequired- text. A date and time: "2026-10-02T09:00" on the set's clock, or ISO 8601 with an offset.
Take a post off the schedule
unschedule_postTakes a scheduled post off the calendar and back to the drafts, with its text, pictures and accounts, so it can be edited or scheduled again. Nothing is deleted. Pictures the posting queue held are copied into Buzzmark first; if one can't be, the post stays scheduled. Answers the post's id, its status (draft) and its account ids.
Inputs
post_idRequired- number. The scheduled post's id, from list_posts with status "scheduled".
Delete a draft
delete_draftDeletes a draft for good. A scheduled or published post can't be deleted here: take a scheduled one back to drafts with unschedule_post first. Answers the id and deleted: true.
Inputs
post_idRequired- number. The draft's id, from list_posts with status "draft".
Check a post against the brand voice
check_postScores a post 0 to 100 on how much it sounds like the brand, with a short verdict, the one thing that works or drifts, and up to three edits that would raise the score, each as the whole post rewritten. Checks any text, including text written in this chat, or a draft (post_id), whose score is kept beside it in Buzzmark. Changes nothing in the post. Use it to judge one post before it goes out; for how published posts did, use get_post_stats, and for what they have in common, get_insights.
Inputs
textOptional- text, up to 10,000 characters. The post to check. Leave out to check the draft named by post_id.
post_idOptional- number. A draft to check instead of text, id from list_posts or save_draft. Its score is kept beside it.
platformOptional- text. Buzzmark platform id the post is for. Default: the draft's first account.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
Rewrite a post
rewrite_postReads onlyBuzz rewrites a post one way and answers up to three versions to pick from, in the brand's voice and with Buzzmark's writing rules. Nothing is saved: pass the version the user picks to save_draft. Use it to change one post that already exists, in one way; for new posts from an idea, use write_posts, and to rewrite a saved draft for every platform it goes to and keep those versions on it, adapt_for_platforms. Actions: match_hive (sound like the brand), fix_grammar (spelling and grammar only), sharpen (clearer, tighter), sting (more punch), trim (about half the length), remix (fresh words), expand (one concrete detail more), structure (short lines, easy to scan), warmer, thread_hook (the opening post of a thread), emoji, emoji_bullets, announcement (framed as news), for_platform (rewritten the way the platform reads), custom (follow the user's instruction).
Inputs
actionRequired- one of "match_hive", "fix_grammar", "sharpen", "sting", "trim", "remix", "expand", "structure", "warmer", "thread_hook", "emoji", "emoji_bullets", "announcement", "for_platform", "custom". How to rewrite it. The tool's description says what each action does.
textOptional- text, up to 10,000 characters. The post to rewrite. Leave out to rewrite a draft's part (post_id, part).
post_idOptional- number. A draft to rewrite instead of text, id from list_posts or save_draft. The draft itself doesn't change.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
platformOptional- text. Buzzmark platform id. Needed for for_platform; otherwise it sets the length the rewrite keeps to.
instructionOptional- text, up to 600 characters. For custom: how to rewrite it, in the user's words.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
Give a draft a version per platform
adapt_for_platformsRewrites a draft the way each platform it goes to reads it (or the platforms named), and saves those versions on the draft, as Spread does in the app: the draft's first account keeps the post itself, every other platform gets its own text, with the same pictures. A version saved before for one of those platforms is replaced. Works on a single post, not a thread. A LinkedIn version keeps LinkedIn tags as @[link]; the answer warns about any LinkedIn can't find. Use it once a draft is written and has its accounts; to change the post itself, use rewrite_post (its for_platform action rewrites for one platform without saving), and for new posts, write_posts.
Inputs
post_idRequired- number. The draft's id, from save_draft or list_posts.
platformsOptional- list of text, up to 8. Buzzmark platform ids among the draft's accounts, never the first account's (its text is the post itself). Default: every platform after the first account's.
Post ideas from the news and competitors
get_post_ideasPost ideas for a brand from Buzzmark's Scout: this week's news in its sector, each topic with why it matters now, its sources and two or three angles to post, plus angles from its competitors when Scout has read them. Answers Scout's latest read with its date. With refresh, or when Scout has never read the news for this brand, it reads the news again first (up to a minute, counted as one Scout run). Ideas only: write them up with write_posts.
Inputs
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
refreshOptional- yes or no. Read the news again now instead of answering Scout's latest read. Up to a minute, counted as one Scout run. Default false.
What worked this month
get_insightsWhat a brand's posts from the last 30 days have in common when they do better or worse than its average post, as at most one finding and two moves in plain sentences. LinkedIn posts are read apart and their finding stays in Buzzmark, since LinkedIn doesn't allow its numbers in AI apps. Each says the number it stands on (for example, posts that open with a question got 2.3x the average post's engagement, from 5 of 19 measured posts) and an idea to act on. Posts are compared by platform, whether they open with a number or a question, length, post type, weekday and time of day. Read at most once a day: the same answer comes back until the numbers move. Needs 8 posts with numbers in the 30 days, and says how many it has when there are fewer. Use it to learn what to do more of; for each post and its numbers, use get_post_stats, for the best weekday and hour, get_best_times, and to judge a draft before it goes out, check_post.
Inputs
social_set_idOptional- number. Social set whose brand profile is read, when hive_profile_id is left out. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own, else the account's default brand profile.
Best times to post
get_best_timesReads onlyWhen a social set's own published posts have done best: the 6 strongest weekday and hour slots on the set's clock, best first, each with how many posts it holds and their average engagement (likes + comments + shares or reposts, whichever is larger, + saves) per post. A slot whose posts earned nothing is left out, so a set with no engagement yet gets no slots. Says the set's time zone and how many posts were read. LinkedIn posts aren't counted, since LinkedIn doesn't allow its numbers in AI apps; a set that posts only to LinkedIn gets starter times from a public study and its own posting slots. To post at the best time on any platform, LinkedIn included, schedule_post with when "best_time" lets Buzzmark pick. For how single posts did, use get_post_stats, and for what the posts have in common, get_insights.
Inputs
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
daysOptional- number, 14 to 180. How many days of published posts to read, counted back from now. 14 to 180, default 90.
Rank recent posts by engagement
get_post_statsReads onlyA social set's published posts from the last days, ranked by engagement (likes + comments + shares or reposts, whichever is larger, + saves), best first. Each post comes with its platform, when it went out on the set's clock, its text, its link, its engagement, whether it went out from Buzzmark, and its numbers; the answer also sums the numbers over every post in the window. LinkedIn doesn't allow its numbers in AI apps, so LinkedIn posts come apart in numbers_in_buzzmark_only, newest first, with when they went out, their link and where to see the numbers in Buzzmark, and are left out of the totals. The numbers are impressions, reach, views, likes, comments, shares, saves and clicks, under the platform's own word where it has one (replies, reposts, bookmarks, videoViews and upvotes). A number a platform doesn't report is left out, never shown as 0. Use it to see which posts did best and by how much; for what they have in common, use get_insights, for the best weekday and hour, get_best_times, for drafts and scheduled posts, list_posts, and for one Buzz in full, get_post.
Inputs
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
daysOptional- number, 1 to 180. How many days of published posts to read, counted back from now. 1 to 180, default 30.
limitOptional- number, 1 to 30. How many posts to return, best first. 1 to 30, default 10. The totals still count every post in the window.
Make a picture
create_imageMakes a picture with Buzzmark's image model and keeps it in the user's Library. With post_id it's also added to that draft. The picture takes the Hive profile's colours, and a named Hive product brings its real photo as the reference. Uses one of the month's picture credits; a failed or refused picture isn't counted. Takes about a minute. Answers the picture's link and how many picture credits are left this month.
Inputs
promptRequired- text, up to 3,000 characters. What the picture shows. A photograph by default.
hive_profile_idOptional- number. Brand profile whose colours and products the picture uses, id from list_brand_profiles.
productOptional- text, up to 200 characters. A product name exactly as the Hive profile lists it, to use its photo.
platformsOptional- list of text, up to 8. Where it goes, for the shape (Instagram and Threads 4:5, TikTok 2:3, else square). Default: the draft's platforms.
post_idOptional- number. A draft to add the picture to.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Add a picture or video from a link
add_media_from_urlCopies a picture or video from a public https link into the user's Library in Buzzmark, and with post_id adds it to that draft. Buzzmark keeps its own copy, so the post never depends on the link staying up. Takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB. Says what a platform would refuse, like create_image does.
Inputs
urlRequired- text, up to 2,000 characters. A public https link straight to the file, not to a page that shows it.
post_idOptional- number. A draft to add it to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Get an upload link
create_upload_linkFor a picture or video the user has on their own computer or phone, not at a public link. Answers two ways in, both good for one file: upload_page, a Buzzmark page to send the user, where they pick the file and it goes straight onto the draft (pass post_id); and, with file_name, upload_url, for an app that can read the file itself (a terminal or a file system): PUT the file's bytes there with the Content-Type header the answer gives, then call add_uploaded_media with upload_id. Takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB.
Inputs
file_nameOptional- text, up to 120 characters. The file's name with its ending, like "launch.png", when this app uploads the file itself. Leave it out to only get the page for the user.
post_idOptional- number. A draft to add the file to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Add an uploaded picture or video
add_uploaded_mediaAfter the file was PUT to create_upload_link's upload_url: copies it into the user's Library in Buzzmark, and with post_id adds it to that draft. Answers Buzzmark's own link to the file and whether it's a picture or a video, and with post_id what a platform would refuse, like add_media_from_url does. An upload_id works for 55 minutes.
Inputs
upload_idRequired- text, up to 2,000 characters. upload_id from create_upload_link.
post_idOptional- number. A draft to add it to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Add a picture or video from this chat
add_media_from_chatA picture or video the user attached in this chat: copies it into their Library in Buzzmark, and with post_id adds it to that draft. Answers Buzzmark's own link to the file and whether it's a picture or a video, and with post_id what a platform would refuse. Takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB.
Inputs
fileRequired- object. The file the user attached in the chat.
post_idOptional- number. A draft to add it to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Make a draft a carousel
make_carouselMakes a draft a carousel, in one of two ways. With a topic, Buzz writes the pages in the brand's voice (a cover, the content pages, an outro) and lays them out in one of Buzzmark's looks in the brand's colours and fonts, as Buzzmark's carousel studio does; this counts as one Buzz written for you and takes up to a minute. Without a topic, the draft's pictures become the pages, one full-bleed page each in order, as "Turn these pictures into a carousel" does in Buzzmark: add 2 to 10 pictures first (add_media_from_url, create_upload_link or add_media_from_chat), and the pages take the first picture's shape, 9:16 when it's that tall, else 4:5. A carousel goes to LinkedIn as one PDF document, and to Instagram (4:5 only) and TikTok as slides; schedule_post makes those files. A carousel the draft already has is replaced. Never changes the draft's text: a written carousel comes back with a caption you can offer the user and save with save_draft.
Inputs
post_idRequired- number. The draft that becomes a carousel, id from save_draft or list_posts.
topicOptional- text, up to 2,000 characters. What the carousel is about, in the user's words ("our spring menu: three new dishes and why"). With a topic Buzz writes the pages; leave it out to make the draft's pictures the pages.
pagesOptional- number, 2 to 10. With a topic: how many pages, the cover and the outro included. Default 6. Without a topic the pictures decide.
lookOptional- one of "statement", "editorial", "split". With a topic: how the pages look. statement: the brand's main colour on the cover, one point per page, a big number. editorial: quiet paper pages, a thin rule and a page count. split: a colour block over the words on every page. Default statement.
sizeOptional- one of "portrait", "tall". With a topic: the pages' shape. portrait is 4:5 (LinkedIn, Instagram), tall is 9:16 (TikTok, LinkedIn; Instagram's feed refuses it). Default: tall when the draft goes to TikTok and not Instagram, else portrait. Without a topic the first picture decides.
nameOptional- text, up to 200 characters. The carousel's name, which LinkedIn shows as the document's title; cut to 58 characters. Default: the title Buzz wrote, else the post's first line.
Plan the week
create_weekly_content_planA plan for a social set's next 7 days: what the week is for, 2 to 4 content pillars, and one ready-to-edit post per posting slot, each with its day, time, platform, a picture idea and why it's there. Built from the set's Hive profile, its posting slots, its best times and how recent posts did, and what's already scheduled. LinkedIn's numbers aren't used to write it: Buzzmark moves each LinkedIn-only post to LinkedIn's best slot of its day afterwards. Needs a connected account; with fewer than 8 published posts with numbers it leans on the brand's voice and the platforms' norms, and says so. Kept in the Library. Ask the user first whether they want the posts as drafts: with save_as_drafts every post also becomes a draft, and schedule_posts then puts them all on their slots in one go. Each planned post counts as one Buzz written for you. Takes up to a minute.
Inputs
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
goalOptional- text, up to 600 characters. What the week should do, in the user's words: a launch, an event, more bookings.
startOptional- text. First day, YYYY-MM-DD on the set's clock. Default: tomorrow.
save_as_draftsOptional- yes or no. Also save every planned post as a draft, ready for schedule_posts. Ask the user first. Default false.
Send posts to a client for review
send_for_reviewMakes a review link for posts of one social set, for someone outside the account, such as a client. They open it without signing in, see each post as it will appear, and approve it, ask for changes or comment. Works for drafts, posts waiting for approval and scheduled posts. Answers the link, which is shown once, and when it stops working. Nothing is sent to anyone: give the link to the user to pass on. To check a post against the brand voice yourself, use check_post.
Inputs
post_idsRequired- list of number, up to 30. The posts to send, ids from list_posts or save_draft. All from the same social set.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
client_nameOptional- text, up to 80 characters. Who the link is for. Shown to them as a greeting and to the team beside what they decide.
daysOptional- number, 1 to 60. How many days the link works. Default 14.
allow_approveOptional- yes or no. false makes a link for reading and commenting only. Default true.
Make a link for a client to connect their accounts
create_connect_linkMakes a connect link for one social set, for someone outside the account, such as a client. They open it without signing in to Buzzmark, sign in to each platform themselves, and the accounts are added to that social set. Works for Instagram, LinkedIn, Facebook, X, Threads, TikTok, Google Business, Bluesky (they type an app password they make in Bluesky, never their own password) and Pinterest (they pick a board). Answers the link, which is shown once, and when it stops working: 7 days, once per platform. Nothing is sent to anyone: give the link to the user to pass on. Each connected account counts toward the accounts the Buzzmark account can hold. To see which accounts a social set already has, use list_social_sets.
Inputs
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
platformsRequired- list of text, up to 9. The platforms the client should connect, one account each.
List a Pinterest account's boards
list_pinterest_boardsReads onlyThe boards a connected Pinterest account can pin to, read live from Pinterest: each board's id, its name and whether it's secret. A pin always goes to a board the user picks: show them the boards and ask which one, then pass its id to schedule_post in pinterest.boards. To find the Pinterest accounts in a social set, use list_social_sets.
Inputs
account_idRequired- number. The Pinterest account's id, from list_social_sets.