Update a customer
Update a customer
Overview
Update a customer
Partial update; send only fields that change (email, phone, metadata, etc.).
When to use this
Use when buyers edit their profile or when syncing CRM changes into lomi.
Authentication
Merchant routes require an API key in the X-API-KEY header (see Integration overview). Use a test key against https://sandbox.api.lomi.africa and a live key against https://api.lomi.africa.
Endpoint
PATCH /customers/{id}
Base URLs:
https://sandbox.api.lomi.africahttps://api.lomi.africa
Request
Path parameters
| Name | Required | Schema | Description |
|---|---|---|---|
id | Yes | - | UUID du client |
Query parameters
No query parameters.
Headers
| Name | In | Required | Schema | Description |
|---|---|---|---|---|
Lomi-Account | header | No | - | Optional lomi. Network account id (acct_...). When present, the API key acts as the Operator and the request targets the connected Member Account. |
Request body
JSON request payload.
Schema: object
| Field | Required | Type | Description |
|---|---|---|---|
name | No | string | - |
email | No | string | - |
phone_number | No | string | - |
whatsapp_number | No | string | - |
country | No | string | - |
city | No | string | - |
address | No | string | - |
postal_code | No | string | - |
is_business | No | boolean | - |
metadata | No | object | - |
Example body:
{
"name": "string",
"email": "string",
"phone_number": "string"
}Responses
| Status | Description |
|---|---|
200 | Success |
400 | Bad request, invalid or missing parameters |
401 | Invalid or missing API key |
404 | Resource not found |
Errors
Errors follow the standard JSON error format (status code and machine-readable message). Validate inputs before calling; 401 indicates a missing/invalid key, 404 a missing resource for this organization, 429 rate limiting. For safe retries on create-style calls, send an idempotency key when your flow supports it.
Example
curl -sS -X PATCH "https://sandbox.api.lomi.africa/customers/value" \
-H "X-API-KEY: $LOMI_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"string","email":"string","phone_number":"string"}'OpenAPI
- operationId:
CustomersController_update - Operation:
PATCH /customers/{id}
Full schemas and Try it: API reference. Machine-readable contract: repo apps/docs/openapi.json.