Creates a new customer; can also be created alongside a new subscription. The only validation restriction is that you may only create one customer for a given reference value.
If provided, the reference value must be unique. It represents a unique identifier for the customer from your own app, i.e. the customer’s ID. This allows you to retrieve a given customer via a piece of shared information. Alternatively, you may choose to leave reference blank, and store Advanced Billing’s unique ID for the customer, which is in the id attribute.
Full documentation on how to locate, create and edit Customers in the Advanced Billing UI can be located here.
Advanced Billing requires that you use the ISO Standard Country codes when formatting country attribute of the customer.
Countries should be formatted as 2 characters. For more information, see the following wikipedia article on ISO_3166-1.
Advanced Billing requires that you use the ISO Standard State codes when formatting state attribute of the customer.
US States (2 characters): ISO_3166-2
States Outside the US (2-3 characters): To find the correct state codes outside of the US, go to ISO_3166-1 and click on the link in the “ISO 3166-2 codes” column next to country you wish to populate.
Advanced Billing allows you to attribute a language/region to your customer to deliver invoices in any required language. For more: Customer Locale
The username is a Maxio Chargify API key and the password is x. Basic authentication works only with the US and EU environments, which connect to chargify.com directly. The Maxio API Gateway environment does not accept Basic authentication.
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
curl -X POST \ --url 'https://subdomain.chargify.com/customers.json' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ --data-raw '{ "customer": { "first_name": "Martha", "last_name": "Washington", "email": "martha@example.com", "cc_emails": "george@example.com", "organization": "ABC, Inc.", "reference": "1234567890", "address": "123 Main Street", "address_2": "Unit 10", "city": "Anytown", "state": "MA", "zip": "02120", "country": "US", "phone": "555-555-1212", "locale": "es-MX" }}'