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

# Get Inbox Address

> Get the address anyone can email to reach your inbox

Get the email address that delivers straight to your inbox. People, services and other AI agents can write to it; each message opens a new conversation, or joins the conversation it answers. Replies to your campaigns, sequences and transactional email arrive in the same inbox through their own reply-to addresses.

The default address is `inbox+{companyId}@inbound.sequenzy.com` and always works. You can also choose a branded address such as `support@inbound.acme.com` on one of your verified sending domains with [Update Inbox Address](./update-inbox-address). Once it is active, `address` returns it. `addresses` lists every address that currently delivers to this inbox.

Email only arrives while receiving is on (`enabled`). Turn it on in **Settings → Inbox**, or with [Update Company](../companies/update) and `replyTrackingEnabled`. Email sent to the inbox address does not trigger `email.replied` webhooks or automations and is not auto-forwarded. Mail that fails the spam or virus scan is dropped.

Requires the `conversations:read` scope.

## Request

This endpoint takes no parameters.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/conversations/inbox-address" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response fields

<ResponseField name="inbox.enabled" type="boolean">
  Whether the company receives email. When `false`, replies and inbox address
  email are not stored.
</ResponseField>

<ResponseField name="inbox.address" type="string">
  The address to share: your branded address once it is active, otherwise the
  default address.
</ResponseField>

<ResponseField name="inbox.defaultAddress" type="string">
  `inbox+{companyId}@inbound.sequenzy.com`. Always works while receiving is on.
</ResponseField>

<ResponseField name="inbox.addresses" type="string[]">
  Every address that currently delivers to this inbox, starting with `address`.
</ResponseField>

<ResponseField name="inbox.customAddress" type="object | null">
  The branded address you chose, or `null`: `localPart`, `domain`, `address`
  (`null` until the domain's inbound host is known) and `status` (`active` once
  its inbound MX record is verified, otherwise `pending`).
</ResponseField>

<ResponseField name="inbox.attachmentsAvailable" type="boolean">
  Whether attachment content is stored, so attachments can be downloaded,
  forwarded and sent with replies.
</ResponseField>

<ResponseField name="inbox.retentionDays" type="integer">
  Days received email and its attachments are kept. At least 90.
</ResponseField>

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "inbox": {
      "enabled": true,
      "address": "support@inbound.example.com",
      "defaultAddress": "inbox+comp_abc123@inbound.sequenzy.com",
      "addresses": [
        "support@inbound.example.com",
        "inbox+comp_abc123@inbound.sequenzy.com",
        "inbox+comp_abc123@inbound.example.com"
      ],
      "customAddress": {
        "localPart": "support",
        "domain": "example.com",
        "address": "support@inbound.example.com",
        "status": "active"
      },
      "attachmentsAvailable": true,
      "retentionDays": 90
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": "API key is missing required scope: conversations:read"
  }
  ```
</ResponseExample>