Update a customer

PUT

https://api-dev.skiplino.com/external/v1/customers/update

Updates a customer identified by id or externalId. Only the fields you send are
changed; omitted fields are left untouched.

Authentication — Secret key only (sk_…).

Identification rules

Provide id or externalId to locate the record.

When you locate by id, an externalId in the body is treated as a new value and
must be unique within the company (excluding this record).

When you locate by externalId only, it must reference an existing record.

Behavioural notes

A located-but-then-missing record returns 404 with error: null.

metadata is replaced wholesale when provided (not deep-merged).

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Customer updated successfully.

Bodyapplication/json

🟠404

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Update name/mobile by internal idUpdate email by external idAssign a new external id while locating by internal id

curl --location --request PUT 'https://api-dev.skiplino.com/external/v1/customers/update' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
    "name": "Layla A. Hassan",
    "mobile": "+97333778899"
}'

Response Example

200 - Success

{
    "message": "Customer updated successfully.",
    "data": {
        "_id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
        "externalId": "crm-7741",
        "companyId": "cmp_5f3a91",
        "name": "Layla A. Hassan",
        "email": "layla.hassan@example.com",
        "mobile": "+97333778899",
        "metadata": {
            "tier": "gold"
        },
        "createdAt": "2026-06-23T11:00:00.000Z",
        "updatedAt": "2026-06-23T12:30:00.000Z"
    }
}

Fetch one customer

Delete a customer