---
title: "Update Email Address"
method: PATCH
path: "/core/email-addresses/{address_id}"
tags: ["Email Addresses"]
---

# Update Email Address

`PATCH /core/email-addresses/{address_id}`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/email-addresses/{address_id}`
- Auth: HTTP bearer

## Path parameters

- `address_id` string, required

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- EmailAddressUpdateRequest: Patch an inbound email routing address.
  - `inbound_agent_version_id` string, nullable
  - `outbound_from_address` string, nullable
  - `enabled` boolean, nullable
  - `handler` 'agent' | 'demo', nullable
  - `handler_config` DemoHandlerConfig: ``email_addresses.handler_config`` for a ``handler = 'demo'`` address. Stored as jsonb, so every field needs a default — an address created before a field existed must still resolve.
    - `include_phone_number` boolean: Purchase a Twilio number for each demo. Off by default: every request would otherwise buy a number. When off, the completion email omits the phone row entirely rather than showing a blank.
    - `instructions` string, nullable: Extra steering passed to demo research/generation.
    - `from_display_name` string, nullable: Display name on outbound demo mail.
    - `signature` string, nullable: Plain-text signature appended to demo mail.
    - `reply_to_all` boolean: CC everyone else on the inbound thread on replies.
    - `ignore_senders` string[]: Addresses or bare domains that may never trigger a demo build from this address. For senders the auto-generated header guard misses — another demo mailer, a helpdesk autoresponder — which would otherwise read the company URL out of our own reply and loop.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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