Skip to main content
POST
/
v1
/
customers
/
Create customer
curl --request POST \
  --url https://api.useaira.com/v1/customers/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "externalId": "705faf65-9c8b-4053-8c0b-2021281ce83f",
  "name": "Acme Inc.",
  "parentCustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "type": "individual"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "externalId": "705faf65-9c8b-4053-8c0b-2021281ce83f",
  "name": "Acme Inc.",
  "type": "individual",
  "invoicePrefix": "ACMEI",
  "parentCustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "archivedAt": "2023-11-07T05:31:56Z",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  }
}

Authorizations

​
X-API-KEY
string
header
required

API Key Authentication.

Body

application/json

Schema representing a customer.

​
externalId
string
required

An optional external identifier of the customer from the external system, used throughout the system to identify the customer.

Pattern: ^[a-zA-Z0-9_-]+$
Example:

"705faf65-9c8b-4053-8c0b-2021281ce83f"

​
name
string
required

The name of the customer.

Example:

"Acme Inc."

​
parentCustomerId
null | string<uuid>

Parent customer ID when customer is a subsidiary.

​
customFields
object

Custom fields that can be associated with the entity. The fields must be previously created in the system before they can be used.

Example:
{
  "customField1": "value1",
  "customField2": ["value2", "value3"]
}
​
type
enum<string>
default:individual

Customer type in organizations hierarchy.

Available options:
individual,
organization,
subsidiary
Example:

"individual"

​
paymentAccount
object

Optional payment account to create together with the customer. When provided, a legal entity is created and linked to the customer in the same transaction.

Response

Schema representing a customer.

​
id
string<uuid>
required

The unique identifier of the customer in our system.

​
externalId
string
required

An optional external identifier of the customer from the external system, used throughout the system to identify the customer.

Pattern: ^[a-zA-Z0-9_-]+$
Example:

"705faf65-9c8b-4053-8c0b-2021281ce83f"

​
name
string
required

The name of the customer.

Example:

"Acme Inc."

​
type
enum<string>
required

Customer type in organizations hierarchy.

Available options:
individual,
organization,
subsidiary
Example:

"individual"

​
invoicePrefix
string

The prefix of the customer's invoices. This is generated by the system and cannot be updated.

Example:

"ACMEI"

​
parentCustomerId
null | string<uuid>

Parent customer ID when customer is a subsidiary.

​
archivedAt
null | string<date-time>

Archive timestamp for customers that were archived.

​
customFields
object

Custom fields that can be associated with the entity. The fields must be previously created in the system before they can be used.

Example:
{
  "customField1": "value1",
  "customField2": ["value2", "value3"]
}