# PATCH /sending/identities/{identityId}

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Update a sender identity, replacing its fields.

```http
PATCH https://api.sendheron.com/api/v1/sending/identities/{identityId}
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `sending:write`

**Success status:** `200`

**Rate limit:** 100/min per key, counted against the organization's WRITE ceiling (400/min).

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `identityId` | uuid | yes | Sender identity UUID. |

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `label` | string | yes | Human label shown when picking a sender, e.g. `Acme Billing`. |
| `fromEmail` | string | yes | The From address. Accepted whatever its domain, and reported as unsendable until that domain is authenticated in this workspace. |
| `fromName` | string | no | Display name recipients see beside the address. |
| `replyToEmail` | string | no | Where replies go, when that differs from the From address. Its domain does not have to be authenticated. |

> Pointing the From address at an authenticated domain is itself a remedy: sequence enrollments this workspace parked for want of a verified sender resume as soon as the default identity can send.


---

Rate limits: 100/min per key, counted against the organization's WRITE ceiling (400/min). Both windows are one minute; there is no hourly or daily quota.