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.
`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 specific reply under the root post. The caller should be the owner of the root post.
`reply_control` string	Optional. Can be used to specify who can reply to a post. Values: `everyone`, `accounts_you_follow`, `mentioned_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.

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