Skip to main content
PUT
/
customers
/
{id}
{
  "firstName": "<string>",
  "lastName": "<string>",
  "id": "<string>",
  "email": "[email protected]",
  "birthday": "2023-12-25",
  "ssnLastFour": "<string>",
  "timezone": "<string>",
  "phoneNumber": "<string>",
  "streetAddress1": "<string>",
  "streetAddress2": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zipCode": "<string>",
  "doNotCall": true,
  "isTest": true,
  "taskType": "<string>",
  "externalMetadata": {}
}

Name Fields

You can update the customer’s name by providing either or both fields:
  • firstName - Update customer’s first name
  • lastName - Update customer’s last name
Both fields are optional, allowing you to update them independently. The API response will return both fields separately as they are stored in the database.

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string
required

ID of customer to update

Body

application/json

Customer to update

id
string
required

Unique identifier for the customer. This is your customer reference and should match your internal system's ID.

firstName
string
required

The first name of the customer

lastName
string
required

The last name of the customer

email
string<email>
required

Customer email address

birthday
string<date>
required

Customer birthday in YYYY-MM-DD format

Example:

"1985-06-15"

streetAddress1
string
required

Street address line 1 (required)

Example:

"123 Main St"

city
string
required

City (required)

Example:

"San Francisco"

state
string
required

State code (required)

Example:

"CA"

zipCode
string
required

ZIP/postal code (required)

Example:

"94102"

taskType
string
required

Type of tasks to create for the customer's automated call schedule. Valid values depend on company configuration. This field is required.

Example:

"collections"

ssnLastFour
string

Last 4 digits of SSN

Example:

"1234"

timezone
string

Timezone of the customer (IANA timezone name, e.g., 'America/New_York', 'America/Los_Angeles')

phoneNumber
string

Phone number of the customer

streetAddress2
string

Street address line 2 (optional)

Example:

"Apt 4B"

doNotCall
boolean

Do not call the customer

isTest
boolean

Indicates if this is a test customer

test
boolean
default:false

Mark customer as test customer

externalMetadata
object

Additional custom metadata about the customer (e.g. employer information, pay schedule, additional contact details)

Response

Customer response

firstName
string
required

The first name of the customer

lastName
string
required

The last name of the customer

id
string

Unique identifier for the customer. This is your customer reference and should match your internal system's ID.

email
string<email>

Customer email address

birthday
string<date>

Customer birthday in YYYY-MM-DD format

ssnLastFour
string

Last 4 digits of SSN

timezone
string

Timezone of the customer (IANA timezone name, e.g., 'America/New_York', 'America/Los_Angeles')

phoneNumber
string

Phone number of the customer

streetAddress1
string

Street address line 1

streetAddress2
string

Street address line 2 (optional)

city
string

City name

state
string

State code (e.g., NY, CA)

zipCode
string

ZIP/postal code

doNotCall
boolean

Do not call the customer

isTest
boolean

Indicates if this is a test customer

taskType
string

Type of tasks created for the customer's automated call schedule

externalMetadata
object

Additional custom metadata about the customer