Email addresses

Update an address

Change an address's endpoint route or active state.

PATCH/api/v1/addresses/%7Bid%7D

cURL

curl -X PATCH "https://inboundr.net/api/v1/addresses/{id}" \
  -H "Authorization: Bearer $INBOUNDR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpointId": "<endpointId>",
    "active": true
  }'

Repoints an address to a different endpoint (or makes it store-only), and/or toggles whether it's active. Provide at least one field.

idstringpathrequired

The address id (addr_…).

endpointIdstring | nullbody

A webhook endpoint (ep_…) to deliver to, or null to make the address store-only. Must be an endpoint you own.

activebooleanbody

Whether the address accepts mail.

Example response

200

{
  "id": "addr_123",
  "domainId": "dom_123",
  "localPart": "support",
  "endpointId": null,
  "active": true,
  "createdAt": "2026-07-20T10:00:00.000Z",
  "domain": "yourdomain.com",
  "address": "support@yourdomain.com"
}

Returns 400 if endpointId is unknown, or 404 if the address isn't yours.