---
title: thread.created
description: A new conversation started.
sidebar:
  label: thread.created
  icon: message-square-plus
---

A new conversation started — by an inbound message, by a send that didn't join an existing thread, or by a [forward](/guides/threads#forwarding).

## Payload

| Prop | Type | Default | Description |
| - | - | - | - |
| `thread_id` | `string` | - | thr_… |
| `subject` | `string` | - | The opening subject. |
| `mailbox` | `string` | - | The address on your side. |
| `forward_of` | `string \| null` | - | When a forward opened the thread: the thread it carries a transcript of. |

## Handling it

Subscribe to this when you want to create a record — a ticket, a CRM entry — once per conversation rather than once per message. Every later message on the conversation reuses this `thread_id`, so the record never needs to be de-duplicated afterwards.

**[Threads](/guides/threads)**

How a reply is matched onto an existing thread instead of opening a new one.