> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rename Sender Profile

> Rename a sender (From) profile without changing account defaults

Rename one sender (From) profile in place. Only the display name changes: the address, its sending domain, and the account-wide default From selection are left exactly as they were.

Use this to standardize a display name across the several identities one mailbox may carry - for example, consolidating `Viraj from SnapCount` down to `SnapCount`. Campaigns and sequences pinned to this profile pick up the new name on their next send.

<Note>
  To change *which* profile is the account default, use [Update
  Company](/api-reference/companies/update) with `senderProfileId` instead. That
  endpoint renames and promotes in one step; this one never touches the default.
</Note>

Get profile IDs from [List Sender Profiles](/api-reference/sender-profiles/list). Requires the `companies:manage` scope.

## Request

<ParamField path="id" type="string" required>
  Sender profile ID.
</ParamField>

<ParamField body="name" type="string" required>
  New display name. Trimmed before saving; must be non-empty and 255 characters
  or fewer.
</ParamField>

```bash theme={null}
curl -X PATCH "https://api.sequenzy.com/api/v1/sender-profiles/sender_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "SnapCount"}'
```

## Response fields

<ResponseField name="renamed" type="boolean">
  `false` when the profile already carried that name, so nothing changed. Lets a
  retried call report accurately instead of claiming a change that never
  happened.
</ResponseField>

<ResponseField name="senderProfile.isDefault" type="boolean">
  Whether this profile is the account default. This endpoint never changes it.
</ResponseField>

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "senderProfile": {
      "id": "sender_abc123",
      "name": "SnapCount",
      "email": "hello@snapcount.app",
      "domain": "snapcount.app",
      "domainStatus": "verified",
      "canSend": true,
      "isDefault": true
    },
    "renamed": true
  }
  ```

  ```json 400 theme={null}
  {
    "error": "name cannot be empty."
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Unauthorized"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "API key is missing required scope: companies:manage"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Sender profile not found"
  }
  ```

  ```json 409 theme={null}
  {
    "error": "Another sender identity for hello@snapcount.app is already named \"SnapCount\" (sender_def456). Rename or remove that one first, or point your campaigns at it instead."
  }
  ```
</ResponseExample>
