# PATCH /email/configs/:id

**Resource:** [Email](./email.md)  
**Scopes:** `email-config:write`  
**Write operation:** yes

Partial update of an email configuration. Same shape validation as POST: pass from_email_handle (local-part only) to change the Postmark sender address; passing from_email returns FROM_EMAIL_NOT_WRITABLE. gmail_sender_alias must be a registered send-as alias for the connected user (ALIAS_NOT_CONNECTED, GMAIL_NOT_CONNECTED, GMAIL_USER_REQUIRED).

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Email config ID |
| `from_email_handle` | body | string | no | Local-part of the Postmark sender address (e.g. "support"). Server appends @mail.trustpager.net. Error code INVALID_FROM_EMAIL_HANDLE if regex fails. Passing from_email returns FROM_EMAIL_NOT_WRITABLE. |
| `from_name` | body | string | no | Sender display name |
| `staff_email` | body | string | no | Staff notification email |
| `config_name` | body | string | no | Config display name |
| `is_default` | body | boolean | no | Set as default config |
| `gmail_sender_user_id` | body | uuid | no | User UUID whose connected Gmail account owns the alias |
| `gmail_sender_alias` | body | string | no | Gmail send-as alias. Must already be registered in the connected Gmail account and assigned to this workspace. Use GET /email/capabilities to see valid aliases. |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`