---
title: "Update account"
method: PATCH
path: "/account"
tags: ["Account"]
---

# Update account

`PATCH /account`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/account`
- Auth: HTTP bearer

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.

## Request body

- AccountDetailsUpdate: Represents the business identity of your account when updating it.
  - `email` string, email: Email address for this entity.

## Response `200`

The request has succeeded.

- object
  - `data` AccountDetails, required: Represents the business identity of an account.
    - `id` string, required: Unique Paddle ID for this account, prefixed with `slr_`.
    - `legacy_id` string, nullable, required: Numeric ID for this account. Include this value when contacting Paddle support. Use `id` to identify this account programmatically.
    - `legal_name` string, nullable, 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.
    - `display_name` string, nullable, 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.
    - `website` string, uri, nullable, required: Website for the product or service sold through this account. Only Paddle can change this, so contact Paddle support to update it.
    - `email` string, email, nullable, required: Email address for this entity.
  - `meta` Meta, 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.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/account/patch.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)