Sending Addresses
Set the default Sending Address
Choose the ready Sending Address RouteKite should use by default.
POST
/api/v1/sending-addresses/{senderId}/set-defaultOn this page
Authentication
Send a RouteKite API key as a Bearer token. This endpoint requires the domain:manage scope.
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Required | Bearer API key with the required workspace scope.Example: Bearer rk_your_key |
Path parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
senderId | uuid | Required | Sending Address identifier returned by RouteKite. |
Response
| Name | Type | Requirement | Description |
|---|---|---|---|
object | string | Always | Always sending_address. |
id | uuid | Always | Sending Address identifier. |
domain_id | uuid | Always | Owning domain. |
email | Always | Verified From address. | |
display_name | string | Always | Name recipients see. |
reply_to | email | null | Always | Optional reply destination. |
status | string | Always | ready or disabled. |
is_default | boolean | Always | Whether this is the workspace default. |
Errors
| Status | Code | What it means | What to do |
|---|---|---|---|
| 401 | UNAUTHORIZED | The API key is invalid. | Check the Bearer header. |
| 403 | FORBIDDEN | The key cannot read sending configuration. | Use domain:read, domain:manage, or legacy email:send access. |
| 404 | DOMAIN_NOT_FOUND | The domain is not in this workspace. | Check the domain ID and API key workspace. |
| 429 | RATE_LIMITED | Too many requests were made. | Honor Retry-After before retrying. |
| 503 | SETUP_UNAVAILABLE | Configuration could not be loaded. | Retry after a short delay. |
| 409 | DOMAIN_ALREADY_EXISTS | The domain is already configured. | Use the existing domain or choose another. |
| 409 | DOMAIN_NOT_READY | DNS verification is incomplete. | Publish every required record and verify the domain. |
| 422 | SENDING_ADDRESS_INVALID | The address does not match the selected domain. | Use an address on the verified domain. |