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.",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "externalId": "705faf65-9c8b-4053-8c0b-2021281ce83f",
  "name": "Acme Inc.",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "invoicePrefix": "ACMEI"
}

Authorizations

​
X-API-KEY
string
header
required

API Key Authentication.

Body

application/json

Schema representing a customer.

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. This field can not be updated.

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

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

​
name
string
required

The name of the customer.

Example:

"Acme Inc."

​
customFields
object
required

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"]
}

Response

Schema representing a customer.

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. This field can not be updated.

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

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

​
name
string
required

The name of the customer.

Example:

"Acme Inc."

​
customFields
object
required

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"]
}
​
invoicePrefix
string

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

Example:

"ACMEI"