For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling โ€” append .md to any URL.

Skip to content
Paddle Docs home

Update account

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

PATCH/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.

Requires account.write permission.

Request body

emailstring (email)
Example: test@paddle.com
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

Response (200)

dataobjectrequired
Represents the business identity of an account.
idstringrequired
Example: slr_01k1e8w9df9pz73s399svdkxtg
Unique Paddle ID for this account, prefixed with slr_.
Pattern: ^slr_[a-z\d]{26}$
legacy_idstring | nullrequired
Numeric ID for this account. Include this value when contacting Paddle support. Use id to identify this account programmatically.
Pattern: ^[0-9]+$
legal_namestring | nullrequired
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_namestring | nullrequired
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
websitestring (uri) | nullrequired
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
emailstring (email) | nullrequired
Example: test@paddle.com
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
metaobjectrequired
Information about this response.
request_idstringrequired
Example: b15ec92e-8688-40d4-a04d-f44cbec93355
Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
Request
{
"email": "billing@example.com"
}
Response
{
"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"
}
}

Was this page helpful?