Publishing

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 that is intended to be quoted.
`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`

`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.