Customers

Customer entities hold information about the people and businesses that you sell to. They're related to addresses and businesses.

Customers are the people and businesses that you sell products in your catalog to.

Paddle automatically creates customers for you as part of the checkout, or you can create and manage them using the Dashboard or API.

Customer entities hold information like:

Who you're billing
What their email address is
Whether they've opted-in to marketing from you

Customers have two sub-entities:

Addresses, which hold information about customer billing addresses
Businesses, which hold information that you need when working with a business

Customers, addresses, and businesses work with checkouts, transactions, and subscriptions to bill for products and prices.

Learn how to create a complete customer with a related address and business. See: Work with customers

There's no delete operation for customers. Use the update a customer operation to archive customers when you no longer need them. See: Delete entities

Attributes

idstring

Unique Paddle ID for this customer entity, prefixed with ctm_.

namestring or null

Full name of this customer. Required when creating transactions where collection_mode is manual (invoices).

emailstring<email>

Email address for this customer.

marketing_consentboolean

Whether this customer opted into marketing from you. Set to true by Paddle where a customer checks the marketing consent box when using Paddle Checkout; false otherwise.

statusstring

Whether this entity can be used in Paddle.

custom_dataobject or null

Your own structured key-value data.

localestring

Valid IETF BCP 47 short form locale tag. If omitted, defaults to en.

created_atstring<date-time>

RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.

updated_atstring<date-time>

RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.

import_metaobject or null

Import information for this entity. null if this entity is not imported.

external_idstring or null

Reference or identifier for this entity from the solution where it was imported from.

imported_fromstring

Name of the platform where this entity was imported from.

List customers

gethttps://api.paddle.com/customers

Create a customer

posthttps://api.paddle.com/customers

Get a customer

gethttps://api.paddle.com/customers/{customer_id}

Update a customer

patchhttps://api.paddle.com/customers/{customer_id}

List credit balances for a customer

gethttps://api.paddle.com/customers/{customer_id}/credit-balances