Customers

Create or update a customer (bulk-import friendly)

Creates the customer if missing, otherwise patches the existing row. Tag operations are additive — submitted tags are merged with the existing set (case-insensitively; stored lower-case); no tag removal happens here. Deliberately does NOT fire the welcome-bonus path; use /api/v1/register for trusted onboarding.

post/api/v1/customers

Request

  • Base URL: https://makeup.land
  • URL: https://makeup.land/api/v1/customers
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional client-generated idempotency token (recommended: UUIDv4). Retries with the same key within 24h replay the original response.

Request body

phonestring required

Phone number in E.164 format, e.g. +972501234567

namestring

Required when creating a new customer

emailstring email
tagsstring[]

Tags to union in. Tag identity is case-insensitive (Pro == pro); tags are stored normalized (trimmed, lower-case).

Response

Updated existing customer

createdboolean required

true when the customer was newly created

Changes

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