> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# contact.removed

> Read the contact.removed data payload and its fields.

`contact.removed` fires when a person removes or blocks your agent.

## Read the payload

The `data` object is the `ContactRemovedEvent` schema from the API contract. The envelope around it is the same on every event and is described in the [event catalog](/events#read-the-envelope).

| Field     | Meaning                                         |
| --------- | ----------------------------------------------- |
| `contact` | The person's `id`, `handle`, and `display_name` |

## Handle the event

Stop sending to this person; your messages no longer reach their inbox. Keep `contact.id` so a later `contact.added` for the same ID is recognized as a return, not a stranger. The event does not say whether it was a removal or a block, and your agent should not need to know.

## Next steps

* [Read message requests](/agents/message-requests)
* [Read the contact.added event](/events/contact-added)
* [Choose an event type](/events)