Skip to main content
PATCH
/
customers
/
{customerId}
Update a customer
curl --request PATCH \
  --url https://api.kelviq.com/api/v1/customers/{customerId}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jane.roe.updated@example.com",
  "name": "Johnathan Doe",
  "metadata": {
    "source": "sdk_import",
    "priority": "very_high",
    "status": "active"
  },
  "billingAddress": {
    "country": "IN",
    "line1": "123 Main Street",
    "line2": "Apt 4B",
    "postalCode": "560001",
    "city": "Bangalore",
    "state": "Karnataka"
  }
}
'
{
  "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "customerId": "unique-customer-id-123",
  "name": "Johnathan Doe",
  "email": "new.customer@example.com",
  "details": {},
  "metadata": {
    "source": "sdk_import",
    "priority": "high",
    "status": "active"
  },
  "billingAddress": {
    "country": "IN",
    "line1": "123 Main Street",
    "line2": "Apt 4B",
    "postalCode": "560001",
    "city": "Bangalore",
    "state": "Karnataka"
  },
  "createdOn": "2025-06-04T06:03:30.195790Z",
  "modifiedOn": "2025-06-04T06:03:30.195831Z"
}

Authorizations

​
Authorization
string
header
required

The Server API Key obtained from the kelviq application. Pass as a Bearer token in the Authorization header. Example: 'Authorization: Bearer YOUR_API_KEY'

Path Parameters

​
customerId
string
required

The client-defined unique identifier for the customer.

Body

application/json

Fields for updating an existing customer. Only provided fields will be updated.

​
email
string<email> | null

The email address of the customer.

Example:

"jane.roe.updated@example.com"

​
name
string | null

The name of the customer.

Example:

"Johnathan Doe"

​
metadata
object

A dictionary of custom key-value pairs. If provided, it typically replaces the existing metadata. Refer to API behavior for merge strategy.

Example:
{
  "source": "sdk_import",
  "priority": "very_high",
  "status": "active"
}
​
billingAddress
object

The billing address of the customer.

Response

200 - application/json

Customer Updated

​
id
string<uuid>

Server-generated unique UUID for the customer record.

Example:

"a1b2c3d4-e5f6-7890-1234-567890abcdef"

​
customerId
string

The client-provided customer identifier.

Example:

"unique-customer-id-123"

​
name
string | null

The customer's name.

Example:

"John Doe"

​
email
string<email> | null

The customer's email.

Example:

"new.customer@example.com"

​
details
object

Any server-added details about the customer (typically read-only).

Example:
{}
​
metadata
object

The metadata associated with the customer.

Example:
{
  "source": "sdk_import",
  "priority": "high"
}
​
billingAddress
object

The billing address of the customer.

​
createdOn
string

Customer created date and time

Example:

"2025-06-04T06:03:30.195790Z"

​
modifiedOn
string

Customer updated date and time

Example:

"2025-06-04T06:03:30.195790Z"