POpostproxy
Direct Messages

Pass thread control (Facebook & Instagram)

Gives the conversation to target_app_id — e.g. a human in Meta's inbox (Page Inbox 263902037430900, Instagram Inbox 1217981644879628). Only works while Postproxy controls the conversation or it is idle. Synchronous; returns the chat.

post/api/chats/{id}/pass_thread_control

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/chats/{id}/pass_thread_control
  • Auth
    HTTP bearer

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Request body

target_app_idstring

Numeric Meta app ID that receives the conversation. Required for pass_thread_control only.

metadatastring

Free-form note forwarded to the receiving app in its handover webhook.

Response

The chat, with metadata.thread_control refreshed.

idstring

Chat hashid

profile_idstring

Profile hashid this chat belongs to

platform'facebook' | 'instagram' | 'telegram' | 'bluesky'

Network ID

participant_external_idstring

Platform-native participant ID

participant_usernamestring nullable

Participant's username (when known)

participant_namestring nullable

Participant's display name (when known)

participant_avatar_urlstring nullable

Stable storage URL of the participant's profile picture (null until fetched)

external_conversation_idstring nullable

Platform's native conversation ID (when known)

last_inbound_atstring nullable

ISO 8601 timestamp of last inbound message

last_outbound_atstring nullable

ISO 8601 timestamp of last outbound message

last_message_atstring nullable

ISO 8601 timestamp of last message in either direction

archivedboolean

Bluesky only — whether the chat is muted/archived

created_atstring

ISO 8601 timestamp of chat creation

external_placement_idstring nullable

The placement the chat runs on — the phone number id on WhatsApp, the Page id on Facebook chats that have one. Null otherwise.

groupboolean

True when the chat is a WhatsApp group rather than a 1:1 conversation.

within_messaging_windowboolean

WhatsApp only. Whether a free-form send is currently allowed — true for 24 hours after the customer’s last inbound message or referral. Outside it, send an approved template.

Changes

No recorded changes to this operation across all 1 revision of this API.