POST
/
customers
Create a customer
curl --request POST \
  --url https://api.cloud.flexprice.io/v1/customers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "address_city": "<string>",
  "address_country": "<string>",
  "address_line1": "<string>",
  "address_line2": "<string>",
  "address_postal_code": "<string>",
  "address_state": "<string>",
  "email": "<string>",
  "external_id": "<string>",
  "integration_entity_mapping": [
    {
      "id": "<string>",
      "provider": "stripe"
    }
  ],
  "metadata": {},
  "name": "<string>",
  "tax_rate_overrides": [
    {
      "auto_apply": true,
      "currency": "<string>",
      "metadata": {},
      "priority": 123,
      "tax_rate_code": "<string>"
    }
  ]
}'
{
  "address_city": "<string>",
  "address_country": "<string>",
  "address_line1": "<string>",
  "address_line2": "<string>",
  "address_postal_code": "<string>",
  "address_state": "<string>",
  "created_at": "<string>",
  "created_by": "<string>",
  "email": "<string>",
  "environment_id": "<string>",
  "external_id": "<string>",
  "id": "<string>",
  "metadata": {},
  "name": "<string>",
  "status": "published",
  "tenant_id": "<string>",
  "updated_at": "<string>",
  "updated_by": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Enter your API key in the format x-api-key <api-key>*

Body

application/json

Customer

Request object for creating a new customer in the system

​
external_id
string
required

external_id is the unique identifier from your system to reference this customer (required)

​
address_city
string

address_city is the city name with maximum 100 characters

Maximum length: 100
​
address_country
string

address_country is the two-letter ISO 3166-1 alpha-2 country code

​
address_line1
string

address_line1 is the primary address line with maximum 255 characters

Maximum length: 255
​
address_line2
string

address_line2 is the secondary address line with maximum 255 characters

Maximum length: 255
​
address_postal_code
string

address_postal_code is the ZIP code or postal code with maximum 20 characters

Maximum length: 20
​
address_state
string

address_state is the state, province, or region name with maximum 100 characters

Maximum length: 100
​
email
string

email is the customer's email address and must be a valid email format if provided

​
integration_entity_mapping
object[]

integration_entity_mapping contains provider integration mappings for this customer

​
metadata
object

metadata contains additional key-value pairs for storing extra information

​
name
string

name is the full name or company name of the customer

​
tax_rate_overrides
object[]

tax_rate_overrides contains tax rate configurations to be linked to this customer

Response

Created

Customer response object containing all customer information

​
address_city
string

AddressCity is the city of the customer's address

​
address_country
string

AddressCountry is the country of the customer's address (ISO 3166-1 alpha-2)

​
address_line1
string

AddressLine1 is the first line of the customer's address

​
address_line2
string

AddressLine2 is the second line of the customer's address

​
address_postal_code
string

AddressPostalCode is the postal code of the customer's address

​
address_state
string

AddressState is the state of the customer's address

​
created_at
string
​
created_by
string
​
email
string

Email is the email of the customer

​
environment_id
string

EnvironmentID is the environment identifier for the customer

​
external_id
string

ExternalID is the external identifier for the customer

​
id
string

ID is the unique identifier for the customer

​
metadata
object

Metadata

​
name
string

Name is the name of the customer

​
status
enum<string>
Available options:
published,
deleted,
archived
​
tenant_id
string
​
updated_at
string
​
updated_by
string