---
title: "chat.thread_control_changed"
method: POST
path: "chat.thread_control_changed"
---

# chat.thread_control_changed

`POST chat.thread_control_changed` (webhook)

Another app passed or took a DM conversation (Facebook & Instagram).

## Payload

- WebhookEventThreadControlChanged: Envelope shared by every webhook delivery.
  - `id` string, required: Delivery ID, prefixed with whevt_. Matches the X-Postproxy-Delivery header.
  - `object` 'event', required: Always "event".
  - `type` string, required: Event type (e.g. platform_post.published). Matches the X-Postproxy-Event header.
  - `created_at` string, required: ISO 8601 timestamp of when the event was generated.
  - `data` object, required: Container for the event-specific resource.
    - `object` object: Another app passed or took a Facebook / Instagram conversation (Meta handover webhook).
      - `chat` object: The full chat object, with metadata.thread_control already updated.
      - `previous_owner_app_id` string: Meta app ID that held the conversation. Absent when it was idle.
      - `new_owner_app_id` string: Meta app ID that now controls the conversation.
      - `metadata` string: Note the other app attached, when present.
      - `occurred_at` string: ISO 8601 time of the handover.

## Acknowledgement `200`

Acknowledged

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)