Paddle Billing
Search

Create a business for a customer

posthttps://api.paddle.com/customers/{customer_id}/businesses

Creates a new business for a customer.

If successful, your response includes a copy of the new business entity.

Path Parameters

customer_idstringrequired

Paddle ID of the customer entity to work with.

Request Body

namestringrequired

Name of this business.

company_numberstring or null

Company number for this business.

tax_identifierstring or null

Tax or VAT Number for this business.

contactsarray[object] or null

List of contacts related to this business, typically used for sending invoices.

namestring

Full name of this contact.

emailstring<email>required

Email address for this contact.

custom_dataobject or null

Your own structured key-value data.

Response

dataobject

Represents a business entity.

idstring

Unique Paddle ID for this business entity, prefixed with biz_.

customer_idstring

Paddle ID for the customer related to this business, prefixed with cus_.

namestring

Name of this business.

company_numberstring or null

Company number for this business.

tax_identifierstring or null

Tax or VAT Number for this business.

statusstring

Whether this entity can be used in Paddle.

contactsarray[object]

List of contacts related to this business, typically used for sending invoices.

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.

custom_dataobject or null

Your own structured key-value data.

import_metaobject or null

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

metaobject

Information about this response.

request_idstring

Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.