# inbox.created

::::callout{intent="warning"}
Inboxes are currently in private beta and only available to a limited
number of users. The response shape might change before GA.

[Get early access](https://resend.com/help?type=report\&message=I+would+like+early+access+to+Inboxes.\&priority=low) if you're interested in testing this feature.

Once you have access, upgrade your Resend SDK to use the new methods:

:::code-group
```bash Node.js
npm install resend@6.28.1-preview-inboxes.2
```

```bash CLI
npm install -g resend-cli@2.22.0-preview-inboxes.2
```
:::
::::

Event triggered whenever an **inbox is created**.

## Response Body Parameters

All webhook payloads follow a consistent top-level structure with
event-specific data nested within the `data` object.

- `type` (string) — The event type that triggered the webhook (e.g., `inbox.created`).

- `created_at` (string) — ISO 8601 timestamp when the webhook event was created.

- `data` (object) — Event-specific data containing detailed information about the event. The data object for the `inbox.created` event contains the following parameters:

  ::::accordion{title="object parameters"}
  - `source` (api | dashboard | agent | system) — What made the change

  - `inbox_id` (string) — The ID of the inbox

  - `inbox` (object) — The inbox, as it is when the webhook is sent

    :::accordion{title="inbox object"}
    - `object` (string) — Always `inbox`

    - `id` (string) — The ID of the inbox

    - `name` (string) — Internal name for the inbox. Recipients do not see it. Falls back to the inbox address

    - `email_address` (string) — The address of the inbox

    - `domain_id` (string) — The ID of the domain the inbox belongs to

    - `receiving_address` (string | null) — The address to forward mail to when forwarding is enabled. `null` otherwise

    - `friendly_name` (string | null) — The name recipients see when mail is sent from this inbox

    - `unread` (number) — The number of unread threads in the inbox

    - `created_at` (string) — ISO 8601 timestamp when the inbox was created
    :::
  ::::

:::code-group
```json
{
  "type": "inbox.created",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "source": "api",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "inbox": {
      "object": "inbox",
      "id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
      "name": "Customer Support",
      "email_address": "support@example.com",
      "domain_id": "d91cd9bd-1176-453e-8fc1-35364d380206",
      "receiving_address": null,
      "friendly_name": "Ada from Support",
      "unread": 3,
      "created_at": "2026-09-29T12:00:00.000Z"
    }
  }
}
```
:::

## Related pages

- [email.bounced](./learn-webhooks-emails-bounced.md)
- [email.clicked](./learn-webhooks-emails-clicked.md)
- [email.complained](./learn-webhooks-emails-complained.md)
- [email.delivered](./learn-webhooks-emails-delivered.md)
- [email.delivery_delayed](./learn-webhooks-emails-delivery-delayed.md)
- [email.failed](./learn-webhooks-emails-failed.md)
- [email.opened](./learn-webhooks-emails-opened.md)
- [email.received](./learn-webhooks-emails-received.md)
- [email.scheduled](./learn-webhooks-emails-scheduled.md)
- [email.sent](./learn-webhooks-emails-sent.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.