/threads | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
threads_create_thread_container | Create a thread media container |
threads_delete_thread | Delete a thread |
threads_get_conversation | Get conversation thread |
threads_get_media_insights | Get thread media insights |
threads_get_pending_replies | Get pending replies awaiting approval |
threads_get_profile_posts | Get a public profile’s threads |
threads_get_replies | Get replies to a thread |
threads_get_thread | Get a single thread |
threads_get_user_insights | Get user-level insights |
threads_get_user_profile | Get authenticated user profile |
threads_list_ghost_posts | List user’s ghost posts |
threads_list_user_threads | List authenticated user’s threads |
threads_lookup_profile | Look up a public profile by username |
threads_manage_pending_reply | Approve or ignore a pending reply |
threads_manage_reply | Hide or unhide a reply |
threads_publish_thread | Publish a thread media container |
threads_create_thread_container
Create a thread media container Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_user_id | string | Yes | — | The Threads user ID. |
alt_text | string | No | — | Alt text for image or video content. |
children | string | No | — | Comma-separated list of carousel item container IDs. Required when media_type is CAROUSEL. Minimum 2, maximum 20 items. |
image_url | string | No | — | Public URL of the image. Required when media_type is IMAGE. |
is_carousel_item | boolean | No | — | Set to true when creating an individual carousel item container. |
link_attachment | string | No | — | URL to attach as a link preview. Only for TEXT posts. |
media_type | string | Yes | — | Type of media. TEXT for text-only posts, IMAGE for image posts, VIDEO for video posts, CAROUSEL for multi-image/video posts. |
reply_control | string | No | — | Controls who can reply to this thread. Only these three values are documented by Meta; other values may be rejected by the API. |
reply_to_id | string | No | — | The ID of an existing thread to reply to. Creates a reply instead of a standalone post. |
text | string | No | — | The text content of the thread. Required when media_type is TEXT. Max 500 characters. |
topic_tag | string | No | — | Topic tag for the post. 1-50 characters, no periods or ampersands. |
video_url | string | No | — | Public URL of the video. Required when media_type is VIDEO. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_user_id": {
"type": "string",
"description": "The Threads user ID."
},
"alt_text": {
"type": "string",
"description": "Alt text for image or video content."
},
"children": {
"type": "string",
"description": "Comma-separated list of carousel item container IDs. Required when media_type is CAROUSEL. Minimum 2, maximum 20 items."
},
"image_url": {
"type": "string",
"description": "Public URL of the image. Required when media_type is IMAGE."
},
"is_carousel_item": {
"type": "boolean",
"description": "Set to true when creating an individual carousel item container."
},
"link_attachment": {
"type": "string",
"description": "URL to attach as a link preview. Only for TEXT posts."
},
"media_type": {
"type": "string",
"description": "Type of media. TEXT for text-only posts, IMAGE for image posts, VIDEO for video posts, CAROUSEL for multi-image/video posts.",
"enum": [
"TEXT",
"IMAGE",
"VIDEO",
"CAROUSEL"
]
},
"reply_control": {
"type": "string",
"description": "Controls who can reply to this thread. Only these three values are documented by Meta; other values may be rejected by the API.",
"enum": [
"everyone",
"accounts_you_follow",
"mentioned_only"
]
},
"reply_to_id": {
"type": "string",
"description": "The ID of an existing thread to reply to. Creates a reply instead of a standalone post."
},
"text": {
"type": "string",
"description": "The text content of the thread. Required when media_type is TEXT. Max 500 characters."
},
"topic_tag": {
"type": "string",
"description": "Topic tag for the post. 1-50 characters, no periods or ampersands."
},
"video_url": {
"type": "string",
"description": "Public URL of the video. Required when media_type is VIDEO."
}
},
"required": [
"PCID",
"threads_user_id",
"media_type"
]
}
threads_delete_thread
Delete a thread Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The thread media ID to delete. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The thread media ID to delete."
}
},
"required": [
"PCID",
"threads_media_id"
]
}
threads_get_conversation
Get conversation thread Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The root thread media ID of the conversation. |
fields | string | No | — | Comma-separated list of media fields to return. |
reverse | boolean | No | — | If true, returns results in reverse chronological order. Default: true. |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The root thread media ID of the conversation."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return."
},
"reverse": {
"type": "boolean",
"description": "If true, returns results in reverse chronological order. Default: true."
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"threads_media_id"
]
}
threads_get_media_insights
Get thread media insights Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The thread media ID to get insights for. |
metric | string | Yes | — | Comma-separated list of metrics. Available: views, likes, replies, reposts, quotes, shares. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The thread media ID to get insights for."
},
"metric": {
"type": "string",
"description": "Comma-separated list of metrics. Available: views, likes, replies, reposts, quotes, shares."
}
},
"required": [
"PCID",
"threads_media_id",
"metric"
]
}
threads_get_pending_replies
Get pending replies awaiting approval Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The thread media ID to get pending replies for. |
fields | string | No | — | Comma-separated list of media fields to return. |
reverse | boolean | No | — | If true, returns results in reverse chronological order. Default: true. |
approval_status | string | No | — | Filter by approval status: ‘pending’ or ‘ignored’. |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The thread media ID to get pending replies for."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return."
},
"reverse": {
"type": "boolean",
"description": "If true, returns results in reverse chronological order. Default: true."
},
"approval_status": {
"type": "string",
"description": "Filter by approval status: 'pending' or 'ignored'.",
"enum": [
"pending",
"ignored"
]
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"threads_media_id"
]
}
threads_get_profile_posts
Get a public profile’s threads Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
username | string | Yes | — | Unique username on Threads. Must be an exact match. |
fields | string | No | — | Comma-separated list of media fields to return. |
since | string | No | — | Start date for filtering (ISO 8601 or Unix timestamp). |
until | string | No | — | End date for filtering (ISO 8601 or Unix timestamp). |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"username": {
"type": "string",
"description": "Unique username on Threads. Must be an exact match."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return."
},
"since": {
"type": "string",
"description": "Start date for filtering (ISO 8601 or Unix timestamp)."
},
"until": {
"type": "string",
"description": "End date for filtering (ISO 8601 or Unix timestamp)."
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"username"
]
}
threads_get_replies
Get replies to a thread Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The thread media ID to get replies for. |
fields | string | No | — | Comma-separated list of media fields to return. |
reverse | boolean | No | — | If true, returns results in reverse chronological order. Default: true. |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The thread media ID to get replies for."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return."
},
"reverse": {
"type": "boolean",
"description": "If true, returns results in reverse chronological order. Default: true."
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"threads_media_id"
]
}
threads_get_thread
Get a single thread Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_media_id | string | Yes | — | The thread media ID. |
fields | string | No | — | Comma-separated list of media fields to return. Available: id, media_product_type, media_type, media_url, permalink, owner, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, quoted_post, reposted_post, alt_text, link_attachment_url, gif_url, topic_tag, status, error_message. Use status and error_message to poll container readiness before publishing IMAGE/VIDEO/CAROUSEL. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_media_id": {
"type": "string",
"description": "The thread media ID."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return. Available: id, media_product_type, media_type, media_url, permalink, owner, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, quoted_post, reposted_post, alt_text, link_attachment_url, gif_url, topic_tag, status, error_message. Use status and error_message to poll container readiness before publishing IMAGE/VIDEO/CAROUSEL."
}
},
"required": [
"PCID",
"threads_media_id"
]
}
threads_get_user_insights
Get user-level insights Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_user_id | string | Yes | — | The Threads user ID. |
metric | string | Yes | — | Comma-separated list of metrics. Available: views, likes, replies, reposts, quotes, clicks, followers_count, follower_demographics. |
since | integer | No | — | Start of the date range as a Unix timestamp. Earliest allowed: 1712991600. |
until | integer | No | — | End of the date range as a Unix timestamp. Earliest allowed: 1712991600. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_user_id": {
"type": "string",
"description": "The Threads user ID."
},
"metric": {
"type": "string",
"description": "Comma-separated list of metrics. Available: views, likes, replies, reposts, quotes, clicks, followers_count, follower_demographics."
},
"since": {
"type": "integer",
"description": "Start of the date range as a Unix timestamp. Earliest allowed: 1712991600."
},
"until": {
"type": "integer",
"description": "End of the date range as a Unix timestamp. Earliest allowed: 1712991600."
}
},
"required": [
"PCID",
"threads_user_id",
"metric"
]
}
threads_get_user_profile
Get authenticated user profile Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fields | string | No | — | Comma-separated list of fields to return. Available: id, username, name, threads_profile_picture_url, threads_biography, is_verified |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"fields": {
"type": "string",
"description": "Comma-separated list of fields to return. Available: id, username, name, threads_profile_picture_url, threads_biography, is_verified"
}
},
"required": [
"PCID"
]
}
threads_list_ghost_posts
List user’s ghost posts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_user_id | string | Yes | — | The Threads user ID. Use ‘me’ for the authenticated user. |
fields | string | No | — | Comma-separated list of media fields to return. |
since | string | No | — | Start date for filtering. |
until | string | No | — | End date for filtering. |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_user_id": {
"type": "string",
"description": "The Threads user ID. Use 'me' for the authenticated user."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return."
},
"since": {
"type": "string",
"description": "Start date for filtering."
},
"until": {
"type": "string",
"description": "End date for filtering."
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"threads_user_id"
]
}
threads_list_user_threads
List authenticated user’s threads Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_user_id | string | Yes | — | The Threads user ID. Use ‘me’ for the authenticated user. |
fields | string | No | — | Comma-separated list of media fields to return. Available: id, media_product_type, media_type, media_url, permalink, owner, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, quoted_post, reposted_post, alt_text, link_attachment_url, gif_url, topic_tag |
since | string | No | — | Start date for filtering (ISO 8601 or Unix timestamp). |
until | string | No | — | End date for filtering (ISO 8601 or Unix timestamp). |
limit | integer | No | — | Number of results per page. |
after | string | No | — | Cursor for forward pagination. Use the ‘after’ value from the previous response’s paging.cursors object. |
before | string | No | — | Cursor for backward pagination. Use the ‘before’ value from the previous response’s paging.cursors object. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_user_id": {
"type": "string",
"description": "The Threads user ID. Use 'me' for the authenticated user."
},
"fields": {
"type": "string",
"description": "Comma-separated list of media fields to return. Available: id, media_product_type, media_type, media_url, permalink, owner, username, text, timestamp, shortcode, thumbnail_url, children, is_quote_post, quoted_post, reposted_post, alt_text, link_attachment_url, gif_url, topic_tag"
},
"since": {
"type": "string",
"description": "Start date for filtering (ISO 8601 or Unix timestamp)."
},
"until": {
"type": "string",
"description": "End date for filtering (ISO 8601 or Unix timestamp)."
},
"limit": {
"type": "integer",
"description": "Number of results per page."
},
"after": {
"type": "string",
"description": "Cursor for forward pagination. Use the 'after' value from the previous response's paging.cursors object."
},
"before": {
"type": "string",
"description": "Cursor for backward pagination. Use the 'before' value from the previous response's paging.cursors object."
}
},
"required": [
"PCID",
"threads_user_id"
]
}
threads_lookup_profile
Look up a public profile by username Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
username | string | Yes | — | Handle or unique username on Threads. Must be an exact match. |
fields | string | No | — | Comma-separated list of fields to return. Available: id, username, name, threads_profile_picture_url, threads_biography, is_verified, follower_count, likes_count, quotes_count, reposts_count, views_count |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"username": {
"type": "string",
"description": "Handle or unique username on Threads. Must be an exact match."
},
"fields": {
"type": "string",
"description": "Comma-separated list of fields to return. Available: id, username, name, threads_profile_picture_url, threads_biography, is_verified, follower_count, likes_count, quotes_count, reposts_count, views_count"
}
},
"required": [
"PCID",
"username"
]
}
threads_manage_pending_reply
Approve or ignore a pending reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_reply_id | string | Yes | — | The pending reply ID to manage. |
approve | boolean | Yes | — | Set to true to approve the reply, false to ignore it. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_reply_id": {
"type": "string",
"description": "The pending reply ID to manage."
},
"approve": {
"type": "boolean",
"description": "Set to true to approve the reply, false to ignore it."
}
},
"required": [
"PCID",
"threads_reply_id",
"approve"
]
}
threads_manage_reply
Hide or unhide a reply Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_reply_id | string | Yes | — | The reply ID to manage. |
hide | boolean | Yes | — | Set to true to hide the reply, false to unhide. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_reply_id": {
"type": "string",
"description": "The reply ID to manage."
},
"hide": {
"type": "boolean",
"description": "Set to true to hide the reply, false to unhide."
}
},
"required": [
"PCID",
"threads_reply_id",
"hide"
]
}
threads_publish_thread
Publish a thread media container Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
threads_user_id | string | Yes | — | The Threads user ID. |
creation_id | string | Yes | — | The media container ID returned from the create thread container endpoint. |
Show inputSchema
Show inputSchema
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"threads_user_id": {
"type": "string",
"description": "The Threads user ID."
},
"creation_id": {
"type": "string",
"description": "The media container ID returned from the create thread container endpoint."
}
},
"required": [
"PCID",
"threads_user_id",
"creation_id"
]
}