Focus · Threads
Typed Focus mode operations for Threads accounts, generated from the Threads focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_threads- Posts11
- Ghost posts3
- Reposts3
- Locations2
- Commented posts1
- Replies6
- Conversation4
- Pending replies3
- Mentions2
- Quote mentions2
- My replies2
- Keyword search2
- Recent searches1
- Benchmarks2
- Profile posts1
- Account insights1
- Post insights1
- Quotes reposts1
- Demographics1
- Link clicks1
- Polls1
- Publishing limit1
- Profile1
- Publishing defaults2
- Connection2
Posts
Threads: List Posts
/accounts/{accountId}/threads/postsYour Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Create a Posts item
/accounts/{accountId}/threads/postsPublish now (Threads has no native scheduling; schedule through Socialit posts). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-create (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
Text, image, video or carousel (2–20) post with any Threads option.
contentstringPost text (≤500; emoji count by UTF-8 bytes)
≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
replyControlstringWho can reply. Alias: reply_control.
everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleanHold replies for approval (pending replies). Not with ghost posts.
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
ghostPostbooleanGhost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
quotePostIdstringQuote this Threads post id (also post.quoteExternalId).
replyToIdstringPublish as a reply to this post id (also post.replyToExternalId).
allowlistedCountryCodesarray of stringGeo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
locationIdstringLocation tag id from location search (threads_location_tagging).
crossShareToInstagrambooleanAlso share to the linked Instagram account as a Story (threads_share_to_instagram).
crossShareToInstagramDarkModebooleanDark-mode Instagram Story.
autoPublishTextbooleanPublish TEXT posts in one call (auto_publish_text).
threadarray of objectFollow-up posts chained after the root (each replies to the previous one).
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
threadItemsarray of objectZernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
firstCommentstringSelf-reply posted under the root post (counts toward 250/24 h).
≤ 500 characters
altTextstringFallback alt text for single-media posts.
≤ 1000 characters
checkQuotabooleanCheck threads_publishing_limit before publishing (fails fast at 250/24 h).
Returns object
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlyResponses
Threads: Get a Posts item
/accounts/{accountId}/threads/posts/{itemId}Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlyResponses
Threads: Delete a Posts item
/accounts/{accountId}/threads/posts/{itemId}Delete the post (100 deletes / 24 h). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-delete (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Threads: Quote (Posts)
/accounts/{accountId}/threads/posts/{itemId}/quoteQuote. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-quote (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
Text, image, video or carousel (2–20) post with any Threads option.
contentstringPost text (≤500; emoji count by UTF-8 bytes)
≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
replyControlstringWho can reply. Alias: reply_control.
everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleanHold replies for approval (pending replies). Not with ghost posts.
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
ghostPostbooleanGhost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
quotePostIdstringQuote this Threads post id (also post.quoteExternalId).
replyToIdstringPublish as a reply to this post id (also post.replyToExternalId).
allowlistedCountryCodesarray of stringGeo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
locationIdstringLocation tag id from location search (threads_location_tagging).
crossShareToInstagrambooleanAlso share to the linked Instagram account as a Story (threads_share_to_instagram).
crossShareToInstagramDarkModebooleanDark-mode Instagram Story.
autoPublishTextbooleanPublish TEXT posts in one call (auto_publish_text).
threadarray of objectFollow-up posts chained after the root (each replies to the previous one).
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
threadItemsarray of objectZernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
firstCommentstringSelf-reply posted under the root post (counts toward 250/24 h).
≤ 500 characters
altTextstringFallback alt text for single-media posts.
≤ 1000 characters
checkQuotabooleanCheck threads_publishing_limit before publishing (fails fast at 250/24 h).
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Reply (Posts)
/accounts/{accountId}/threads/posts/{itemId}/replyReply. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Repost (Posts)
/accounts/{accountId}/threads/posts/{itemId}/repostRepost. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-repost (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Insights (Posts)
/accounts/{accountId}/threads/posts/{itemId}/insightsLifetime views, likes, replies, reposts, quotes and shares. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-insights (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Validate draft (Posts)
/accounts/{accountId}/threads/posts/validatePre-flight checks (length, links, media, option combinations) without publishing. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-validate (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
Text, image, video or carousel (2–20) post with any Threads option.
contentstringPost text (≤500; emoji count by UTF-8 bytes)
≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
replyControlstringWho can reply. Alias: reply_control.
everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleanHold replies for approval (pending replies). Not with ghost posts.
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
ghostPostbooleanGhost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
quotePostIdstringQuote this Threads post id (also post.quoteExternalId).
replyToIdstringPublish as a reply to this post id (also post.replyToExternalId).
allowlistedCountryCodesarray of stringGeo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
locationIdstringLocation tag id from location search (threads_location_tagging).
crossShareToInstagrambooleanAlso share to the linked Instagram account as a Story (threads_share_to_instagram).
crossShareToInstagramDarkModebooleanDark-mode Instagram Story.
autoPublishTextbooleanPublish TEXT posts in one call (auto_publish_text).
threadarray of objectFollow-up posts chained after the root (each replies to the previous one).
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
threadItemsarray of objectZernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
Show 10 item attributes
contentstring≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
mediaItemsarray of objectZernio alias of media.
≤ 20 items
Show 4 item attributes
urlstring (uri)requiredtypestringimagevideogif
mimeTypestringaltTextstring≤ 1000 characters
linkAttachmentstring (uri)Link preview card (TEXT posts only). Alias: link_attachment.
pollarray of string | objectPoll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
One of 2 shapes
Option 1 array of string
Option 2 object
optionsarray of string2–4 items
option_astringoption_bstringoption_cstringoption_dstringgifobjectGIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
Show 2 child attributes
gifIdstringrequiredproviderstringdefault: "GIPHY"GIPHY
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
spoilerMediabooleanBlur the image/video/carousel as a spoiler (is_spoiler_media).
textAttachmentobjectLong-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
Show 3 child attributes
plaintextstringrequired≤ 10000 characters
linkAttachmentUrlstring (uri)Not allowed when linkAttachment is set.
stylingarray of objectNon-overlapping style ranges.
Show 3 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
stylesarray of stringrequiredtopicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
firstCommentstringSelf-reply posted under the root post (counts toward 250/24 h).
≤ 500 characters
altTextstringFallback alt text for single-media posts.
≤ 1000 characters
checkQuotabooleanCheck threads_publishing_limit before publishing (fails fast at 250/24 h).
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Container status (Posts)
/accounts/{accountId}/threads/posts/container-statusIN_PROGRESS / FINISHED / PUBLISHED / ERROR / EXPIRED with error_message. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-container-status (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
container_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Web intent link (Posts)
/accounts/{accountId}/threads/posts/web-intentthreads.net composer link prefilled with text (no API call). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.
Try it with MCPAsk your agent to call threads-posts-web-intent (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringurlstring (uri)reply_controlstringtopic_tagstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Ghost posts
Threads: List Ghost posts
/accounts/{accountId}/threads/ghost-postsText posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.
Try it with MCPAsk your agent to call threads-ghost-posts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Create a Ghost posts item
/accounts/{accountId}/threads/ghost-postsText posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.
Try it with MCPAsk your agent to call threads-ghost-posts-create (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
contentstringrequired≤ 500 characters
textSpoilersarray of objectText ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
≤ 10 items
Show 2 item attributes
offsetintegerrequiredlengthintegerrequired≥ 1
replyControlstringWho can reply. Alias: reply_control.
everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
topicTagstringOne topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
1–50 characters · pattern ^[^.&]+$
Returns object
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlyResponses
Threads: Delete a Ghost posts item
/accounts/{accountId}/threads/ghost-posts/{itemId}Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.
Try it with MCPAsk your agent to call threads-ghost-posts-delete (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Reposts
Threads: List Reposts
/accounts/{accountId}/threads/repostsPosts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call threads-reposts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Create a Reposts item
/accounts/{accountId}/threads/repostsPosts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call threads-reposts-create (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
post_idstringrequiredThreads media id to repost
Returns object
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlyResponses
Threads: Delete a Reposts item
/accounts/{accountId}/threads/reposts/{itemId}Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.
Try it with MCPAsk your agent to call threads-reposts-delete (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Locations
Threads: List Locations
/accounts/{accountId}/threads/locationsSearch places to tag on posts (500 searches / 24 h). Use the id as locationId when composing. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: /v1/accounts/{accountId}/focus/locations.
Try it with MCPAsk your agent to call threads-locations-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringPlace name
latitudenumberlongitudenumberReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlynamestringaddressstring | nullcitystring | nullcountrystring | nulllatitudenumber | nulllongitudenumber | nullpostal_codestring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Get a Locations item
/accounts/{accountId}/threads/locations/{itemId}Search places to tag on posts (500 searches / 24 h). Use the id as locationId when composing. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: /v1/accounts/{accountId}/focus/locations.
Try it with MCPAsk your agent to call threads-locations-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlynamestringaddressstring | nullcitystring | nullcountrystring | nulllatitudenumber | nulllongitudenumber | nullpostal_codestring | nullResponses
Commented posts
Threads: List Posts with replies
/accounts/{accountId}/threads/commented-postsYour recent posts that have replies — the entry point to moderation. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/commented-posts.
Try it with MCPAsk your agent to call threads-commented-posts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlytextstring | nullpermalinkstring (uri) | nullcreated_atstring (date-time)media_typestring | nullthumbnail_urlstring (uri) | nullhas_repliesbooleanlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Replies
Threads: List Replies
/accounts/{accountId}/threads/repliesTop-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringrequiredThreads post id
reversebooleandefault: trueNewest first
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringread-onlytextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_avatar_urlstring (uri) | nullauthor_verifiedboolean | nullcreated_atstring (date-time)like_countintegerAlways 0: Threads exposes no reply like counts
permalinkstring (uri) | nullmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullhas_repliesbooleanparent_idstring | nullroot_idstring | nullroot_owner_idstring | nullis_replybooleanis_ownbooleanhide_statusstring | nullNOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED
hiddenbooleanreply_audiencestring | nullis_quote_postbooleanquoted_post_idstring | nulltopic_tagstring | nullapproval_statusstring | nullpendingignoredapproved
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Create a Replies item
/accounts/{accountId}/threads/repliesReply to a post or reply (reply_to_id). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-create (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
reply_to_idstringrequiredtextstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
idstringread-onlytextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_avatar_urlstring (uri) | nullauthor_verifiedboolean | nullcreated_atstring (date-time)like_countintegerAlways 0: Threads exposes no reply like counts
permalinkstring (uri) | nullmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullhas_repliesbooleanparent_idstring | nullroot_idstring | nullroot_owner_idstring | nullis_replybooleanis_ownbooleanhide_statusstring | nullNOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED
hiddenbooleanreply_audiencestring | nullis_quote_postbooleanquoted_post_idstring | nulltopic_tagstring | nullapproval_statusstring | nullpendingignoredapproved
Responses
Threads: Delete a Replies item
/accounts/{accountId}/threads/replies/{itemId}Delete one of your own replies. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-delete (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Threads: Reply (Replies)
/accounts/{accountId}/threads/replies/{itemId}/replyReply. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Hide (Replies)
/accounts/{accountId}/threads/replies/{itemId}/hideHide a top-level reply (nested replies are hidden with it). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-hide (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Unhide (Replies)
/accounts/{accountId}/threads/replies/{itemId}/unhideUnhide. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.
Try it with MCPAsk your agent to call threads-replies-unhide (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Conversation
Threads: List Conversation
/accounts/{accountId}/threads/conversationThe full, flattened conversation of a post (top-level and nested replies). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.
Try it with MCPAsk your agent to call threads-conversation-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringrequiredThreads post id
reversebooleandefault: trueNewest first
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringread-onlytextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_avatar_urlstring (uri) | nullauthor_verifiedboolean | nullcreated_atstring (date-time)like_countintegerAlways 0: Threads exposes no reply like counts
permalinkstring (uri) | nullmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullhas_repliesbooleanparent_idstring | nullroot_idstring | nullroot_owner_idstring | nullis_replybooleanis_ownbooleanhide_statusstring | nullNOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED
hiddenbooleanreply_audiencestring | nullis_quote_postbooleanquoted_post_idstring | nulltopic_tagstring | nullapproval_statusstring | nullpendingignoredapproved
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Reply (Conversation)
/accounts/{accountId}/threads/conversation/{itemId}/replyReply. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.
Try it with MCPAsk your agent to call threads-conversation-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Hide (Conversation)
/accounts/{accountId}/threads/conversation/{itemId}/hideHide a top-level reply (nested replies are hidden with it). The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.
Try it with MCPAsk your agent to call threads-conversation-hide (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Unhide (Conversation)
/accounts/{accountId}/threads/conversation/{itemId}/unhideUnhide. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.
Try it with MCPAsk your agent to call threads-conversation-unhide (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pending replies
Threads: List Reply approvals
/accounts/{accountId}/threads/pending-repliesReplies held for approval on posts published with reply approvals. Approve or ignore them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.
Try it with MCPAsk your agent to call threads-pending-replies-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
post_idstringrequiredapproval_statusstringdefault: "pending"pendingignored
reversebooleandefault: truelimitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringread-onlytextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_avatar_urlstring (uri) | nullauthor_verifiedboolean | nullcreated_atstring (date-time)like_countintegerAlways 0: Threads exposes no reply like counts
permalinkstring (uri) | nullmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullhas_repliesbooleanparent_idstring | nullroot_idstring | nullroot_owner_idstring | nullis_replybooleanis_ownbooleanhide_statusstring | nullNOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED
hiddenbooleanreply_audiencestring | nullis_quote_postbooleanquoted_post_idstring | nulltopic_tagstring | nullapproval_statusstring | nullpendingignoredapproved
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Approve (Reply approvals)
/accounts/{accountId}/threads/pending-replies/{itemId}/approveApprove. Replies held for approval on posts published with reply approvals. Approve or ignore them. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.
Try it with MCPAsk your agent to call threads-pending-replies-approve (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Threads: Ignore (Reply approvals)
/accounts/{accountId}/threads/pending-replies/{itemId}/ignoreIgnore. Replies held for approval on posts published with reply approvals. Approve or ignore them. Destructive. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.
Try it with MCPAsk your agent to call threads-pending-replies-ignore (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Mentions
Threads: List Mentions
/accounts/{accountId}/threads/mentionsPublic posts that @mention you, including quote posts. Reply from here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call threads-mentions-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlykindstringmentionreplyquote
textstring | nullauthorstring | nullauthor_usernamestring | nullcreated_atstring (date-time)like_countintegerpermalinkstring (uri) | nullpost_idstringmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullalt_textstring | nullhas_repliesbooleanis_quote_postbooleanquoted_post_idstring | nullis_replybooleanparent_idstring | nullroot_idstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Reply (Mentions)
/accounts/{accountId}/threads/mentions/{itemId}/replyReply. Public posts that @mention you, including quote posts. Reply from here. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: /v1/accounts/{accountId}/focus/mentions.
Try it with MCPAsk your agent to call threads-mentions-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Quote mentions
Threads: List Quotes
/accounts/{accountId}/threads/quote-mentionsQuote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_mentions. Generic route: /v1/accounts/{accountId}/focus/quote-mentions.
Try it with MCPAsk your agent to call threads-quote-mentions-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlykindstringmentionreplyquote
textstring | nullauthorstring | nullauthor_usernamestring | nullcreated_atstring (date-time)like_countintegerpermalinkstring (uri) | nullpost_idstringmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullalt_textstring | nullhas_repliesbooleanis_quote_postbooleanquoted_post_idstring | nullis_replybooleanparent_idstring | nullroot_idstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Reply (Quotes)
/accounts/{accountId}/threads/quote-mentions/{itemId}/replyReply. Quote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Requires scopes: threads_manage_mentions. Generic route: /v1/accounts/{accountId}/focus/quote-mentions.
Try it with MCPAsk your agent to call threads-quote-mentions-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
My replies
Threads: List My replies
/accounts/{accountId}/threads/my-repliesReplies you published anywhere on Threads. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Generic route: /v1/accounts/{accountId}/focus/my-replies.
Try it with MCPAsk your agent to call threads-my-replies-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringread-onlytextstring | nullauthorstring | nullauthor_usernamestring | nullauthor_avatar_urlstring (uri) | nullauthor_verifiedboolean | nullcreated_atstring (date-time)like_countintegerAlways 0: Threads exposes no reply like counts
permalinkstring (uri) | nullmedia_typestring | nullmedia_urlstring (uri) | nullthumbnail_urlstring (uri) | nullgif_urlstring (uri) | nullhas_repliesbooleanparent_idstring | nullroot_idstring | nullroot_owner_idstring | nullis_replybooleanis_ownbooleanhide_statusstring | nullNOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED
hiddenbooleanreply_audiencestring | nullis_quote_postbooleanquoted_post_idstring | nulltopic_tagstring | nullapproval_statusstring | nullpendingignoredapproved
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Delete a My replies item
/accounts/{accountId}/threads/my-replies/{itemId}Replies you published anywhere on Threads. Requires scopes: threads_read_replies, threads_delete. Generic route: /v1/accounts/{accountId}/focus/my-replies.
Try it with MCPAsk your agent to call threads-my-replies-delete (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Keyword search
Threads: List Listening
/accounts/{accountId}/threads/keyword-searchSearch public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: /v1/accounts/{accountId}/focus/keyword-search.
Try it with MCPAsk your agent to call threads-keyword-search-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
qstringrequiredKeyword, or topic tag when search_mode=TAG
search_typestringdefault: "TOP"TOPRECENT
search_modestringdefault: "KEYWORD"KEYWORDTAG
media_typestringTEXTIMAGEVIDEO
author_usernamestringExact username (without @)
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Reply (Listening)
/accounts/{accountId}/threads/keyword-search/{itemId}/replyReply to a public post found by search (allowed with threads_keyword_search). Search public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: /v1/accounts/{accountId}/focus/keyword-search.
Try it with MCPAsk your agent to call threads-keyword-search-reply (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 500 characters
mediaarray of object≤ 20 items
Show 4 item attributes
urlstring (uri)media_idstringSocialit media id (resolved to a public URL)
typestringimagevideogif
altTextstring≤ 1000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Recent searches
Threads: List Recent searches
/accounts/{accountId}/threads/recent-searchesKeywords you searched recently (shared with the Threads app). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_keyword_search. Generic route: /v1/accounts/{accountId}/focus/recent-searches.
Try it with MCPAsk your agent to call threads-recent-searches-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
querystringsearched_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Benchmarks
Threads: List Benchmarks
/accounts/{accountId}/threads/benchmarksCompare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/benchmarks.
Try it with MCPAsk your agent to call threads-benchmarks-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
usernamesstringrequiredComma-separated usernames
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
usernamestringnamestring | nullavatar_urlstring (uri) | nullbiographystring | nullis_verifiedbooleanfollower_countinteger | nullviews_count_7dinteger | nulllikes_count_7dinteger | nullreplies_count_7dinteger | nullreposts_count_7dinteger | nullquotes_count_7dinteger | nullprofile_urlstring (uri) | nullerrorstring | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Threads: Get a Benchmarks item
/accounts/{accountId}/threads/benchmarks/{itemId}Compare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/benchmarks.
Try it with MCPAsk your agent to call threads-benchmarks-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
usernamestringnamestring | nullavatar_urlstring (uri) | nullbiographystring | nullis_verifiedbooleanfollower_countinteger | nullviews_count_7dinteger | nulllikes_count_7dinteger | nullreplies_count_7dinteger | nullreposts_count_7dinteger | nullquotes_count_7dinteger | nullprofile_urlstring (uri) | nullerrorstring | nullResponses
Profile posts
Threads: List Profile posts
/accounts/{accountId}/threads/profile-postsPublic posts of another profile (competitor content). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/profile-posts.
Try it with MCPAsk your agent to call threads-profile-posts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
usernamestringrequiredsincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
limitintegerdefault: 251–100
cursorstringPagination cursor (next_cursor of the previous page)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 30 item attributes
idstringread-onlytextstring | null≤ 500 characters
media_typestringread-onlyTEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE
media_product_typestring | nullread-onlymedia_urlstring (uri) | nullread-onlythumbnail_urlstring (uri) | nullread-onlypermalinkstring (uri) | nullread-onlyshortcodestring | nullread-onlyusernamestring | nullread-onlyowner_idstring | nullread-onlytimestampstring (date-time)read-onlyis_quote_postbooleanread-onlyquoted_post_idstring | nullread-onlyis_repostbooleanread-onlyreposted_post_idstring | nullread-onlyalt_textstring | null≤ 1000 characters
link_attachment_urlstring (uri) | nullgif_urlstring (uri) | nullread-onlyhas_repliesbooleanread-onlyreply_audiencestring | nullread-onlyeveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
is_spoiler_mediabooleantext_spoilersarray of objectShow 2 item attributes
offsetintegerlengthintegertext_attachmentobject | nullShow 3 child attributes
plaintextstring≤ 10000 characters
link_attachment_urlstring (uri) | nulltext_with_styling_infoarray of objectShow 3 item attributes
offsetintegerlengthintegerstyling_infoarray of stringtopic_tagstring | null≤ 50 characters
location_idstring | nullpollobject | nullShow 3 child attributes
optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nullchildrenarray of stringread-onlyallowlisted_country_codesarray of string | nullghost_post_statusstring | nullread-onlyACTIVEARCHIVED
ghost_post_expires_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Account insights
Threads: Get Overview
/accounts/{accountId}/threads/account-insightsProfile views per day plus likes, replies, reposts, quotes and link clicks, with the current follower count. Data from 2024-06-01. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/account-insights.
Try it with MCPAsk your agent to call threads-account-insights-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
dailybooleanPer-day interactions (one request per day; default for ≤31 days)
Returns object
seriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 10 child attributes
viewsnumberprofile_viewsnumberlikesnumbercommentsnumberReplies
sharesnumberReposts (+ shares on posts)
quotesnumberclicksnumberLink clicks
followersnumberengagementsnumberengagement_ratenumbertotalsobjectShow 10 child attributes
viewsnumberprofile_viewsnumberlikesnumbercommentsnumberReplies
sharesnumberReposts (+ shares on posts)
quotesnumberclicksnumberLink clicks
followersnumberengagementsnumberengagement_ratenumberResponses
Post insights
Threads: List Post performance
/accounts/{accountId}/threads/post-insightsLifetime views, likes, replies, reposts, quotes and shares of your recent posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/post-insights.
Try it with MCPAsk your agent to call threads-post-insights-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
limitintegerdefault: 251–100
sort_bystringdefault: "views"viewslikesrepliesrepostsquotessharesengagements
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringread-onlytextstring | nullpermalinkstring (uri) | nulltimestampstring (date-time)media_typestring | nullthumbnail_urlstring (uri) | nulltopic_tagstring | nullviewsnumberlikesnumberrepliesnumberrepostsnumberquotesnumbersharesnumberengagementsnumberengagement_ratenumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Quotes reposts
Threads: List Quotes & reposts
/accounts/{accountId}/threads/quotes-repostsHow often each of your posts was quoted and reposted (Threads does not list who reposted). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/quotes-reposts.
Try it with MCPAsk your agent to call threads-quotes-reposts-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
limitintegerdefault: 251–100
sort_bystringdefault: "quotes"viewslikesrepliesrepostsquotessharesengagements
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 15 item attributes
idstringread-onlytextstring | nullpermalinkstring (uri) | nulltimestampstring (date-time)media_typestring | nullthumbnail_urlstring (uri) | nulltopic_tagstring | nullviewsnumberlikesnumberrepliesnumberrepostsnumberquotesnumbersharesnumberengagementsnumberengagement_ratenumber | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Demographics
Threads: Get Audience
/accounts/{accountId}/threads/demographicsFollower split by country, city, age and gender (needs ≥100 followers). Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/demographics.
Try it with MCPAsk your agent to call threads-demographics-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
breakdownstringOnly this breakdown (one request)
countrycityagegender
Returns object
countriesarray of objectShow 2 item attributes
keystringvaluenumbercitiesarray of objectShow 2 item attributes
keystringvaluenumberagesarray of objectShow 2 item attributes
keystringvaluenumbergendersarray of objectShow 2 item attributes
keystringvaluenumberage_genderarray of objectShow 3 item attributes
agestringgenderstring | nullvaluenumberunavailablearray of objectShow 2 item attributes
breakdownstringerrorstringResponses
Link clicks
Threads: List Link clicks
/accounts/{accountId}/threads/link-clicksClicks per link in your posts for the period. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Generic route: /v1/accounts/{accountId}/focus/link-clicks.
Try it with MCPAsk your agent to call threads-link-clicks-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date-time)Start (ISO date/time or unix seconds)
untilstring (date-time)End (ISO date/time or unix seconds)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
link_urlstring (uri)clicksintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Polls
Threads: List Poll results
/accounts/{accountId}/threads/pollsYour recent polls with vote percentages, total votes and expiry. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/polls.
Try it with MCPAsk your agent to call threads-polls-list (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 501–100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlytextstring | nullpermalinkstring (uri) | nulltimestampstring (date-time)optionsarray of objectShow 3 item attributes
keystringlabelstringvotes_percentagenumber | nulltotal_votesinteger | nullexpires_atstring (date-time) | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Publishing limit
Threads: Get Publishing limits
/accounts/{accountId}/threads/publishing-limitRolling 24 h usage: 250 posts, 1000 replies, 100 deletes, 500 location searches. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/troubleshooting.md Generic route: /v1/accounts/{accountId}/focus/publishing-limit.
Try it with MCPAsk your agent to call threads-publishing-limit-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
postsobjectShow 4 child attributes
usedintegertotalintegerremainingintegerwindow_secondsintegerrepliesobjectShow 4 child attributes
usedintegertotalintegerremainingintegerwindow_secondsintegerdeletesobjectShow 4 child attributes
usedintegertotalintegerremainingintegerwindow_secondsintegerlocation_searchesobjectShow 4 child attributes
usedintegertotalintegerremainingintegerwindow_secondsintegerResponses
Profile
Threads: Get Profile
/accounts/{accountId}/threads/profileYour Threads profile. Threads has no API to edit name, bio or picture; links are parsed from the bio. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/reference/user.md Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call threads-profile-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlyusernamestringread-onlynamestring | nullread-onlybiographystring | nullread-onlybio_linksarray of stringread-onlyavatar_urlstring (uri) | nullread-onlyis_verifiedbooleanread-onlyprofile_urlstring (uri) | nullread-onlyis_eligible_for_geo_gatingboolean | nullread-onlyResponses
Publishing defaults
Threads: Get Publishing defaults
/accounts/{accountId}/threads/publishing-defaultsDefaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/publishing-defaults.
Try it with MCPAsk your agent to call threads-publishing-defaults-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
replyControlstring | nulleveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleandefault: falsetopicTagstring | null≤ 50 characters
allowlistedCountryCodesarray of string | nullcrossShareToInstagrambooleandefault: falseAlso share new posts to the linked Instagram Story
crossShareToInstagramDarkModebooleandefault: falseautoPublishTextbooleandefault: falsecheckQuotabooleandefault: falseResponses
Threads: Update Publishing defaults
/accounts/{accountId}/threads/publishing-defaultsReturns metadata to persist on the social account. Defaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/publishing-defaults.
Try it with MCPAsk your agent to call threads-publishing-defaults-update (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
replyControlstring | nulleveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleandefault: falsetopicTagstring | null≤ 50 characters
allowlistedCountryCodesarray of string | nullcrossShareToInstagrambooleandefault: falseAlso share new posts to the linked Instagram Story
crossShareToInstagramDarkModebooleandefault: falseautoPublishTextbooleandefault: falsecheckQuotabooleandefault: falseReturns object
replyControlstring | nulleveryoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only
enableReplyApprovalsbooleandefault: falsetopicTagstring | null≤ 50 characters
allowlistedCountryCodesarray of string | nullcrossShareToInstagrambooleandefault: falseAlso share new posts to the linked Instagram Story
crossShareToInstagramDarkModebooleandefault: falseautoPublishTextbooleandefault: falsecheckQuotabooleandefault: falseResponses
Connection
Threads: Get Connection
/accounts/{accountId}/threads/connectionToken validity, expiry and granted permissions vs. the full Threads permission set. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/connection.
Try it with MCPAsk your agent to call threads-connection-get (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
is_validboolean | nulluser_idstring | nullexpires_atstring (date-time) | nulldata_access_expires_atstring (date-time) | nullscopesarray of stringmissing_corearray of stringmissing_focusarray of stringResponses
Threads: Run permission checks (Connection)
/accounts/{accountId}/threads/connection/permission-checksOne API call per granted permission for Meta App Review (publishes and deletes a throwaway post). Token validity, expiry and granted permissions vs. the full Threads permission set. Destructive. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/connection.
Try it with MCPAsk your agent to call threads-connection-permission-checks (toolset focus_threads)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)