Customers

Create a customer

Create a customer. Use the response status and request ID to decide whether to retry, reconcile, or ask the customer for action.

post/api/v1/customers

Request

  • Base URL
    https://merchant.zahlo.eu
  • Auth
    API key in header x-api-key

Headers

Idempotency-Keystring

Retry-safe key for create operations.

Request body

emailstring email required
namestring nullable
phonestring nullable
preferredLocalestring nullable

For example en or de-DE; customer emails use it.

metadataobject

Up to 50 key-value pairs; keys up to 40 characters, values strings up to 500 characters.

Example request

{
  "taxIds": [
    {
      "value": "DE123456789"
    }
  ]
}

Response

The customer

idstring required
object'customer' required
livemodeboolean required
createdAtstring date-time required
emailstring email required
namestring nullable
phonestring nullable
preferredLocalestring nullable

For example en or de-DE; customer emails use it.

metadataobject required

Up to 50 key-value pairs; keys up to 40 characters, values strings up to 500 characters.

defaultPaymentMethodIdstring nullable

Example response

{
  "taxIds": [
    {
      "value": "DE123456789"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.