Update a specific customer's information

PUT /customers/{customer_id}

Path parameters

Body

Update an existing customer

Responses

  • Successful query of information for a specific customer

    Hide response attributes Show response attributes object
    • customer_id string Required

      A Canopy-generated ID for the customer.

    • Prefix to the customer's name. Primary account holder or controlling officer name for Business customers.

    • Customer's first name. Primary account holder or controlling officer name for Business customers.

    • Customer's middle name. Primary account holder or controlling officer name for Business customers.

    • Customer's last name. Primary account holder or controlling officer name for Business customers.

    • Suffix to the customer's name

    • Customer's phone number in E.164 format

    • Address line one.

    • Address line two.

    • Address city.

    • Address state.

    • Five digit zipcode or nine digit 'ZIP+4'

    • ISO 3166-1 alpha-2 country code for the customer.

    • ssn string

      Social security number of the customer.

    • Any country-specific unique identifier for the customer.

    • email string(email)

      The email address of this Customer

    • date_of_birth string(date)

      Customer's date of birth in ISO 8601 format

    • Hide business_details attributes Show business_details attributes object
  • Unauthorized.

  • Forbidden.

  • Customer not found

  • Invalid input

  • Too many requests.

  • Unexpected Error.

PUT /customers/{customer_id}
curl \
 -X PUT https://sandbox-api.canopyservicing.com/customers/1001 \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"name_prefix":"Dr.","name_first":"Miriam","name_middle":"Louise","name_last":"Trevino","name_suffix":"Jr","phone_number":"555-555-5555","address_line_one":"12 Strawberry Road","address_line_two":"Suite 101","address_city":"Atlanta","address_state":"GA","address_zip":"99999-1000","email":"marissa@protonmail.com","ssn":"888-88-8888","date_of_birth":"2018-06-20T09:12:30+00:00"}'
Request example
{
  "name_prefix": "Dr.",
  "name_first": "Miriam",
  "name_middle": "Louise",
  "name_last": "Trevino",
  "name_suffix": "Jr",
  "phone_number": "555-555-5555",
  "address_line_one": "12 Strawberry Road",
  "address_line_two": "Suite 101",
  "address_city": "Atlanta",
  "address_state": "GA",
  "address_zip": "99999-1000",
  "email": "marissa@protonmail.com",
  "ssn": "888-88-8888",
  "date_of_birth": "2018-06-20T09:12:30+00:00"
}
Request examples
{
  "name_prefix": "Dr.",
  "name_first": "Miriam",
  "name_middle": "Louise",
  "name_last": "Trevino",
  "name_suffix": "Jr",
  "phone_number": "555-555-5555",
  "address_line_one": "12 Strawberry Road",
  "address_line_two": "Suite 101",
  "address_city": "Atlanta",
  "address_state": "GA",
  "address_zip": "99999-1000",
  "email": "marissa@protonmail.com",
  "ssn": "888-88-8888",
  "date_of_birth": "2018-06-20T09:12:30+00:00"
}
Response examples (200)
{
  "customer_id": "31mNprzLd2bKl6koVna68ARM",
  "name_prefix": "Dr.",
  "name_first": "Miriam",
  "name_middle": "Louise",
  "name_last": "Trevino",
  "name_suffix": "Jr",
  "phone_number": "+14105556789",
  "address_line_one": "12 Strawberry Road",
  "address_line_two": "Suite 101",
  "address_city": "Atlanta",
  "address_state": "GA",
  "address_zip": "99999-1000",
  "address_country_code": "US",
  "ssn": "888888888",
  "international_customer_id": "9999999999",
  "email": "marissa@protonmail.com",
  "date_of_birth": "1985-06-20",
  "business_details": {
    "business_legal_name": "Umbrella Corporation",
    "doing_business_as": "Umbrella",
    "business_ein": "888-88-8888"
  }
}
Response examples (200)
{
  "customer_id": "31mNprzLd2bKl6koVna68ARM",
  "name_prefix": "Dr.",
  "name_first": "Miriam",
  "name_middle": "Louise",
  "name_last": "Trevino",
  "name_suffix": "Jr",
  "phone_number": "+14105556789",
  "address_line_one": "12 Strawberry Road",
  "address_line_two": "Suite 101",
  "address_city": "Atlanta",
  "address_state": "GA",
  "address_zip": "99999-1000",
  "address_country_code": "US",
  "ssn": "888888888",
  "international_customer_id": "9999999999",
  "email": "marissa@protonmail.com",
  "date_of_birth": "1985-06-20",
  "business_details": {
    "business_legal_name": "Umbrella Corporation",
    "doing_business_as": "Umbrella",
    "business_ein": "888-88-8888"
  }
}