Register

Trusted customer registration intake (WA-inbound + partner)

Designed to be invoked by wa.makeup.land on every inbound WhatsApp contact (WA delivery proves phone ownership) or by partner systems with a register-scoped token. Orchestrates customer create/update, tag merge, webhook dispatch, WhatsApp template, and on first insert materialises M-Club static opportunities. WA template + webhooks fire only when created === true. Returns 201 on create, 200 on update.

post/api/v1/register

Request

  • Base URL: https://makeup.land
  • URL: https://makeup.land/api/v1/register
  • 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
emailstring email
tagstring

Convenience single-tag shortcut. Merged with tags if both supplied.

tagsstring[]
team'yes'

yes marks the customer as part of the team. Off by default.

profile_pic_urlstring uri

Avatar source URL. Must be HTTPS and resolve to an allowlisted host (*.whatsapp.net, *.fbcdn.net). SSRF-guarded.

referred_by_codestring

Referral code — written once on insert, never updated.

referral_sourcestring

Response

Existing customer updated

status'ok' required
customerobject required
createdboolean required
tags_addedstring[]
tags_already_presentstring[]

Changes

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