> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# PATCH /account

**Update account**

Updates the business identity of the account that you're authenticated as.

Send only the fields that you want to change. Fields that you omit keep their current value.

`email` is the only field that you can change. `legal_name`, `display_name`, and `website` appear
on legal and compliance documents, so only Paddle can change them. To change them, contact Paddle support.

Returns an `account_email_conflict` error if the email address is already in use by another account.

If successful, your response includes a copy of the updated account entity.

**Required permissions:** `account.write`

## Request body

- `email`: string (email) — Contact email address for this account. Must be unique across Paddle accounts, so a value already in use returns an `account_email_conflict` error. You can't clear it, because Paddle uses it for account and payout correspondence. (Length: 1–190)

### Request example

```json
{
  "email": "billing@example.com"
}
```

## Response (200)

- `data`: object (required) — Represents the business identity of an account.
  - `id`: string (required) — Unique Paddle ID for this account, prefixed with `slr_`. (pattern: `^slr_[a-z\d]{26}$`)
  - `legacy_id`: string | null (required) — Numeric ID for this account. Include this value when contacting Paddle support. Use `id` to identify this account programmatically. (pattern: `^[0-9]+$`)
  - `legal_name`: string | null (required) — Registered legal name of the business that operates this account. Shown at checkout. Only Paddle can change this, so contact Paddle support to update it. (Max length: 300)
  - `display_name`: string | null (required) — Name shown to customers on invoices, receipts, and in the Paddle customer portal. Only Paddle can change this, so contact Paddle support to update it. (Max length: 300)
  - `website`: string (uri) | null (required) — Website for the product or service sold through this account. Only Paddle can change this, so contact Paddle support to update it. (Max length: 300)
  - `email`: string (email) | null (required) — Contact email address for this account. Paddle uses it for account and payout correspondence, and it may be shown to customers as a support contact. (Length: 1–190)
- `meta`: object (required) — Information about this response.
  - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

### Response example

```json
{
  "data": {
    "id": "slr_01k1e8w9df9pz73s399svdkxtg",
    "legacy_id": "15839",
    "legal_name": "AeroEdit Inc.",
    "display_name": "AeroEdit",
    "website": "https://example.com",
    "email": "billing@example.com"
  },
  "meta": {
    "request_id": "b2c4a1f6-3d8e-4a91-9c07-1e5f8b2d6a34"
  }
}
```