Skip to main content
POST
/
v2
/
customers
/
{customer_id}
Update a customer
curl --request POST \
  --url https://dev.sbx.imprint.co/v2/customers/{customer_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "phone": "+14155552671",
  "first_name": "John",
  "last_name": "Doe",
  "preferred_language": "en",
  "street_line1": "123 Main St",
  "street_line2": "Apt 4B",
  "city": "San Francisco",
  "state": "CA",
  "postal_code": "94105",
  "customer_history": {
    "email": "[email protected]",
    "phone": "+14155552671",
    "first_name": "John",
    "last_name": "Doe",
    "preferred_language": "en",
    "address": {
      "street_line1": "123 Main St",
      "street_line2": "Apt 4B",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105",
      "country": "USA"
    },
    "account_tenure": 13,
    "ltv_amount": 34000,
    "ltv_currency": "USD",
    "loyalty_tier": "GOLD",
    "account_created_at": "2025-02-13T19:08:07.000Z",
    "transaction_count": 100
  },
  "metadata": {
    "preferred_language": "en"
  }
}
'
{
  "id": "9B5E1EE0-2E1C-46E7-81B9-3C3917204BE4",
  "email": "[email protected]",
  "phone": "+14155552671",
  "statuses": {
    "Card Program Name": "OPEN"
  },
  "first_name": "John",
  "last_name": "Doe",
  "preferred_language": "en",
  "ssn4": "1234",
  "date_of_birth": {
    "year": 1990,
    "month": 1,
    "day": 1
  },
  "address": {
    "street_line1": "123 Main St",
    "street_line2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "USA"
  },
  "partner_customer_id": "PARTNER_USER_456",
  "metadata": {
    "preferred_language": "en"
  },
  "created_at": "2025-02-13T19:08:07.000Z",
  "updated_at": "2025-02-13T19:08:07.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

Path Parameters

​
customer_id
string
required

The unique identifier for the customer

Example:

"BBB815E9-F654-438D-9AD3-3F7BB8136FC0"

Body

application/json
​
email
string<email>
​
phone
string
Example:

"+14155552671"

​
first_name
string
Example:

"John"

​
last_name
string
Example:

"Doe"

​
preferred_language
string
Example:

"en"

​
street_line1
string
Example:

"123 Main St"

​
street_line2
string
Example:

"Apt 4B"

​
city
string
Example:

"San Francisco"

​
state
string
Example:

"CA"

​
postal_code
string
Example:

"94105"

​
customer_history
object

A Customer's account history with the partner

​
metadata
object

Additional customer data

Example:
{ "preferred_language": "en" }

Response

Customer updated successfully

Represents a customer in the Imprint system

​
id
string
required

Unique identifier for the customer

Example:

"9B5E1EE0-2E1C-46E7-81B9-3C3917204BE4"

​
email
string<email>

Customer's email address

Example:

"[email protected]"

​
phone
string

Customer's phone number in E.164 format

Example:

"+14155552671"

​
statuses
object

Map of the customer's enrolled card program name to the customer's status.

Example:
{ "Card Program Name": "OPEN" }
​
first_name
string

The customer's first name.

Example:

"John"

​
last_name
string

The customer's last name.

Example:

"Doe"

​
preferred_language
string

Customer's preferred language code as defined by ISO 639-1

Example:

"en"

​
ssn4
string

Customer's Social Security Number in 4 digits

Example:

"1234"

​
date_of_birth
object

Customer's date of birth

​
address
object

Mailing address information

​
partner_customer_id
string

The unique identifier for the customer in the partner's system

Example:

"PARTNER_USER_456"

​
metadata
object

Set of key-value pairs for storing additional information about the customer.

Example:
{ "preferred_language": "en" }
​
created_at
string

the RFC-3339 date when the customer was created

Example:

"2025-02-13T19:08:07.000Z"

​
updated_at
string

the RFC-3339 date when the customer was created

Example:

"2025-02-13T19:08:07.000Z"