Customers

Customer registration is a reference Experience API. It demonstrates Connect patterns; it is not a production customer master.

Flow

1. POST /api/v1/customers (JWT, Operator+)
2. Validate, persist customers, write audit_log and an outbox row PENDING
3. HTTP 201 with Location — no Kafka produce on the request thread
4. Outbox publisher emits CustomerCreated to customer.events
5. Catalog workflow customer-created-consume starts and records message_history

Request

{
  "firstName": "Ada",
  "lastName": "Lovelace",
  "email": "ada@example.com",
  "phone": "+1-555-0100"
}

Optional header: X-Correlation-Id. Errors use RFC 7807 Problem Details.

Try it

APIs → Experience.

If this fails

Next: Orders · Messaging