Publishing

Updated: Apr 20, 2026

Copy for LLM

The Threads publishing endpoints allow you to upload and publish Threads media objects and check their status. See Post to Threads for more information.

`POST /{threads-user-id}/threads`

Upload media and create media containers. See Posts for more information.

Parameters

Name	Description
`access_token` string	Required. Threads Graph API user access token.
`threads-user-id` string	Required. The path parameter of the Threads user identifier.
`media_type` string	Required. Values: `TEXT`, `IMAGE`, `VIDEO`, `CAROUSEL`
`text` string	Optional. The text associated with the post. Uses UTF-8 encoding⁠. For text-only posts, this parameter is required. Note: For the post character limit, emojis are counted as the number of UTF-8 bytes.
`image_url` string	Optional. Required if `media_type=IMAGE`.
`video_url` string	Optional. Required if `media_type=VIDEO`.
`is_carousel_item` Boolean	Optional. Values: `true`, `false` (default)
`children` array	Optional. Required if `media_type=CAROUSEL`.
`reply_to_id` string	Optional. Required if replying to a post.
`reply_control` string	Optional. Can be used to specify who can reply to a post. Values: `everyone`, `accounts_you_follow`, `mentioned_only`, `parent_post_author_only`, `followers_only`
`allowlisted_country_codes` list<string>	Optional. A string list of valid ISO 3166-1 alpha-2 country codes⁠ that represents the countries where this media should be shown. If this parameter is passed in, the media will not be shown to Threads profiles in countries outside of this list.
`alt_text` string	Optional. The accessibility text label or description for an image or video in a Threads post. Note: The maximum length of `alt_text` is 1,000 characters.
`link_attachment` string	Optional. The URL attached to a Threads post.
`quote_post_id` string	Optional. ID of the post to quote.
`poll_attachment` object	Optional. The options for a post with a poll attachment.
`auto_publish_text` Boolean	Optional. When this optional flag is passed, a Threads post is published automatically when a Threads media container is created without needing to go through the extra publish step. Note: This only works for text posts.
`topic_tag` string	Optional. The topic to add to a post. Note: The following characters are not allowed in topic tags: Periods (.) Ampersands (&)
`is_spoiler_media` Boolean	Optional. Indicates if the media should be a spoiler or not. Values: `true`, `false`
`text_entities` object	Optional. The spoiler settings for the post.
`text_attachment` object	Optional. The text attachment for the post.
`gif_attachment` object	Optional. The ID and GIF provider for the GIF to attach to the post. Fields: `gif_id`, `provider`
`is_ghost_post` Boolean	Optional. Indicates if the post is a ghost post or not. Values: `true`, `false`
`enable_reply_approvals` Boolean	Optional. Indicates if the post should have reply approvals enabled. Values: `true`, `false`
`crossreshare_to_ig` Boolean	Optional. Cross-shares a Threads post to a linked Instagram account as a Story when set to `true`. Values: `true`, `false` (default)
`crossreshare_to_ig_dark_mode` Boolean	Optional. Cross-shares a Threads post to a linked Instagram account as a Story in dark mode when set to `true`. Values: `true`, `false` (default)
`location_id` string	Optional. The ID of the location to tag. Note: Use the `GET /location_search` endpoint to find location IDs.

`POST /{threads-user-id}/threads_publish`

Publish uploaded media using their media containers. See Posts for more information.

Parameters

Name	Description
`access_token` string	Required. Threads Graph API user access token.
`threads-user-id` string	Required. The path parameter of the Threads user identifier.
`creation_id` string	Required. Identifier of the Threads media container.

`GET /{threads-container-id}?fields=status`

Check the Threads media container publishing eligibility and status.

Parameters

Name	Description
`access_token` string	Required. Threads Graph API user access token.
`threads-container-id` string	Required. The path parameter of the Threads media container identifier.
`fields` string	Optional. A comma-separated list of the fields to be returned. Values: `id` (default), `status` (default), `error_message`

`POST /{threads-media-id}/repost`

Repost a Threads post that was previously published. See Reposts for more information.

Parameters

Name	Description
`access_token` string	Required. Threads Graph API user access token.
`threads-media-id` string	Required. The path parameter of the Threads media identifier.

`DELETE /{threads-media-id}`

Delete a Threads post. See Delete Posts for more information.

Parameters

Name	Description
`access_token` string	Required. Threads Graph API user access token.
`threads-media-id` string	Required. The path parameter of the Threads media identifier.