# Create an address

> Route an address to an endpoint, or create a store-only inbox.

`POST https://inboundr.net/api/v1/addresses`

Creates an explicit route for one local part on a domain. With an `endpointId`,
matching mail is delivered to that [webhook](/concepts/endpoints); without one
it's **store-only** (kept for retrieval). See [Addresses & routing](/concepts/addresses).

<ParamField body="domainId" type="string" required>
  The domain the address belongs to (`dom_…`). Must be yours.
</ParamField>
<ParamField body="localPart" type="string" required>
  Everything before the `@`, e.g. `support`. 1–64 chars, lowercased; letters,
  digits, and `._+-`.
</ParamField>
<ParamField body="endpointId" type="string">
  A webhook endpoint (`ep_…`) to deliver to. Omit for a store-only inbox.
</ParamField>

<ResponseExample>
```json 201
{
  "id": "addr_123",
  "domainId": "dom_123",
  "localPart": "support",
  "endpointId": "ep_123",
  "active": true,
  "createdAt": "2026-07-20T10:00:00.000Z"
}
```
</ResponseExample>

<Note>
  An explicit address claims that local part even without an endpoint — a
  store-only address opts that address out of the domain's catch-all.
</Note>