---
title: "New Communication Thread Webhook"
source_url: https://docs.rapyd.net/en/new-communication-thread-webhook.html
lang: en
---

# New Communication Thread Webhook

The **NEW_COMMUNICATION_THREAD** webhook is sent when a new communication thread is created.

> **Note:**
>
> The endpoint for webhooks is unique for each client. To set up a webhook endpoint, see [Defining a Webhook Endpoint](https://docs.rapyd.net/en/defining-a-webhook-endpoint.md "Defining a Webhook Endpoint").

### Parameters

### Webhook Header Parameters

- - Content-Type (string)
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt (string)
  - Random string.
- - signature (string)
  - Signature calculated for each webhook individually.

    See [Webhook Authentication](https://docs.rapyd.net/en/webhook-authentication.md "Webhook Authentication").
- - timestamp (string)
  - Timestamp for the webhook, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Webhook Root Parameters

- - created_at (string)
  - Time that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `created_at` field that refers to a different event.
- - data (object)
  - Contains the actual data of the webhook.

    For details, see below.
- - extended_timestamp (string)
  - Time in milliseconds that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - id (string)
  - ID of the webhook. String starting with **wh_**.
- - status (string)
  - Status of the webhook. One of the following:

    - **NEW**
    - **CLO** - Closed.
    - **ERR** - Error.
    - **RET** - Re-sent.

    > **Note:**
    >
    > Inside the `data` object, some webhooks have another `status` field that refers to a different event.
- - trigger_operation_id (string)
  - ID of the operation that triggered the webhook. UUID.
- - type (string)
  - Name of the webhook type.

    > **Note:**
    >
    > The name in the Client Portal is different.

### Webhook Data Parameters

- case_number (string)
- Unique identifier for the case number.

- case_type (string)
- The type of case. The default value is **CASE**.

- created_at (string)
- The Unix Epoch time when the case was created.

- rapyd_merchant_id (string)
- The Rapyd merchant identifier. Value is always populated.

- status (string)
- The status of the case. Values are **open** and **closed**.

- subject (string)
- The subject of the case.

- token (string)
- Unique token for communication thread. String starting with **comm_**. See also the `thread_token` in the response of [Get All Case Communication Threads](https://docs.rapyd.net/en/get-all-case-communication-threads.md "Get All Case Communication Threads").

- updated_at (string)
- The Unix Epoch time when the case was updated.

- legacy_merchant_id (string)
- The former merchant identifier. Value is **null** when not relevant.

- NEW_COMMUNICATION_THREAD Webhook
- ```json
  {
  	"id": "wh_2c2e61ee39911ca830d3d04ae1113c30",
  	"type": "NEW_COMMUNICATION_THREAD",
  	"data": [{
  		"token": "comm_553463e57840650333b1079c212a0a07",
  		"case_number": "287440",
  		"case_type": "CASE",
  		"status": "open",
  		"subject": "Request For Information (RFI)",
  		"created_at": 1752487137,
  		"updated_at": null,		
                  "rapyd_merchant_id": "446dedcf-62c2-43h0-805c-3e7ty9a84619",
                  "legacy_merchant_id": "1205259"
  	}],
  	"trigger_operation_id": "869940ac-1d26-4b1c-9638-5d55baf840b1",
  	"status": "NEW",
  	"created_at": 1752487137
  }
  ```
