---
title: "Update inbox address"
method: PUT
path: "/conversations/inbox-address"
tags: ["Conversations"]
---

# Update inbox address

`PUT /conversations/inbox-address`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/conversations/inbox-address`
- Auth: HTTP bearer

Sets a branded inbox address `{localPart}@{domain}` on one of your receiving domains, or clears it when both fields are null. The address is active once the receiving domain is verified; the default address keeps working. Every other address on the domain reaches the inbox too; the branded one is the address to share. Returns the same body as Get Inbox Address.

## Request body

- object
  - `localPart` string, nullable, required: Name before the @, such as `support`. Letters, numbers, dots, dashes and underscores, starting and ending with a letter or number. Stored in lowercase. Null to clear.
  - `domain` string, nullable, required: One of your receiving domains, by name, such as `acme.com`. For compatibility, the name of a sending domain whose earlier reply setup moved to a receiving domain is also accepted and uses that receiving domain. A verified sending domain with no earlier setup gets its inbound host (usually `inbound.{root}`) added as the workspace's one receiving domain, or fails with 409 `limit_reached` when the workspace already has a different one. Null to clear.

## Response `200`

Inbox address updated

- object
  - `success` boolean
  - `inbox` object: Same shape as Get Inbox Address.

## Other responses

- `400`: Invalid local part (code invalid_local_part), or only one of the two fields is null (code invalid_request)
- `401`: Unauthorized
- `403`: API key is missing the companies:manage scope
- `404`: The domain is not one of your receiving domains (code domain_not_found)
- `409`: Another workspace already uses this address (code address_taken), or domain named a sending domain whose inbound host would need a new receiving domain while the workspace already has one (code limit_reached)
- `422`: Missing localPart or domain field

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/conversations/inbox-address/put.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)