Skip to main content
POST
/
customers
Create customers
curl --request POST \
  --url https://api.getenso.ai/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp",
  "entity": {
    "legalName": "Acme Corporation Private Limited",
    "alias": "Acme",
    "email": [
      "billing@acme.com"
    ],
    "phoneNumber": "9876543210",
    "Addresses": [
      {
        "address1": "123 Business Park Road",
        "city": "Bengaluru",
        "zip": "560001",
        "State": {
          "name": "Karnataka",
          "Country": {
            "name": "India",
            "iso2": "IN",
            "iso3": "IND"
          },
          "code": "KA"
        },
        "address2": "Floor 5, Tower B",
        "taxId": "29ABCDE1234F1Z5"
      }
    ]
  }
}
'
{
  "status": "error",
  "message": "Forbidden",
  "errors": [
    {}
  ]
}
SystemUser permission: CustomerService:createCustomer, EntityService:createEntity

Authorizations

Authorization
string
header
required

JWT bearer token obtained from POST /auth/system-login using your client credentials.

Body

application/json

Customer object that needs to be created

name
string
required
Example:

"Acme Corp"

entity
object
required

Response

Bad request — validation error

status
string
Example:

"error"

message
string
Example:

"Forbidden"

errors
object[]