---
title: "Set the sender name recipients see on mail from one Banger mailbox (\"Name <address>\"). Gmail mailboxes keep the name set in Gmail. Requires workspace admin."
method: PATCH
path: "/v1/workspaces/{workspaceId}/mailboxes/{mailboxId}"
---

# Set the sender name recipients see on mail from one Banger mailbox ("Name <address>"). Gmail mailboxes keep the name set in Gmail. Requires workspace admin.

`PATCH /v1/workspaces/{workspaceId}/mailboxes/{mailboxId}`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/mailboxes/{mailboxId}`
- Auth: HTTP bearer

## Request body

- object
  - `display_name` string, required: One line. Empty sends the bare address.

## Response `200`

The mailbox with its sender name.

- object
  - `data` Mailbox, required
    - `id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `product_id` string, uuid, nullable: The product (project) the mailbox belongs to. Clients group mailboxes and build web-app links with it.
    - `domain_id` string, uuid, nullable
    - `address` string, required: The email address, or for an SMS inbox its phone number in E.164 (+15551234567).
    - `display_name` string, required
    - `provider` 'gmail' | 'smtp' | 'twilio', required
    - `channel` 'email' | 'sms' | 'whatsapp': email; sms for an SMS inbox on Twilio; whatsapp for a WhatsApp inbox, a WhatsApp sender on Twilio for the business's WhatsApp Business account.
    - `sms_verification` object, nullable: A number from Banger, carriers' answer on its toll-free verification. It sends once approved; null for every other mailbox.
      - `status` 'pending_review' | 'in_review' | 'approved' | 'rejected'
      - `reason` string, nullable: Carriers' reason when rejected.
    - `status` 'pending' | 'active' | 'suspended' | 'reconnect_required' | 'disabled', required
    - `status_reason` string, nullable
    - `suspended_at` string, nullable
    - `mailbox_kind` 'domain' | 'starter', required

## Other responses

- `400`: The name has line breaks or is too long.
- `403`: The authenticated actor cannot perform this operation directly.
- `404`: The requested resource does not exist in this workspace.
- `409`: The mailbox sends through Gmail; change its name in Gmail.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)