Update a user

POST

/v3/api/business/reseller/clients/{id}/update

Updates a user's contact details.

This is a partial update: only the fields you send are changed, and anything you omit is left exactly as it was. Sending a field with a blank value is rejected rather than clearing the stored value.

The user's client ID is the anchor for this record and cannot be changed here. If the user does not have a client ID yet, use Set a user's client ID to attach one.

The {id} path segment accepts either the client ID you assigned to the user, or the user_id returned by any user endpoint.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

*/*

Updated user

Body*/*

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/clients/client_abc123/update' \
--header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "Ada",
    "last_name": "Okafor",
    "email": "ada@example.com",
    "phone": "08012345678",
    "calling_code": "+234",
    "label": [
        "VIP",
        "Corporate"
    ]
}'

Response Example

200 - Success

{
    "object": "client",
    "id": "client_abc123",
    "user_id": "usr_10482",
    "first_name": "Ada",
    "last_name": "Okafor",
    "email": "ada@example.com",
    "phone": "08012345678",
    "status": "active",
    "label": [
        "Vip",
        "Corporate"
    ],
    "created": 1746700000,
    "message": "Client updated successfully"
}

Modified at 2026-08-31 14:53:27

Introduction

Set a user's client ID