---
title: "Update a customer by Id"
method: PATCH
path: "/customers/{customerId}"
tags: ["Customers"]
---

# Update a customer by Id

`PATCH /customers/{customerId}`

This is used to update an existing customer

## Path parameters

- `customerId` string, required

## Request body

- object — The request body for updating a customer
  - `firstName` string, nullable — The first name of the customer
  - `lastName` string, nullable — The last name of the customer
  - `homePhoneNumber` string, nullable — The home phone number of the customer. Must be in E.164 format
  - `mobilePhoneNumber` string, nullable — The mobile phone number of the customer. Must be in E.164 format
  - `metadata` object, nullable — use this parameter to attach key-value data to the customer. These will be sent with any associated customer events on your webhooks. You can have a maximum of 5 pieces of metadata.
  - `defaultPaymentMethod` string, nullable — The Id of the customer's preferred/default payment method

## Response `200`

Successfully updated the given Customer

- Customer
  - `id` string — The ID of the customer
  - `email` string, email — The customer's email address
  - `firstName` string, nullable — The first name of the customer
  - `lastName` string, nullable — The last name of the customer
  - `homePhoneNumber` string, nullable — The home phone number of the customer. In E.164 format
  - `mobilePhoneNumber` string, nullable — The mobile phone number of the customer. In E.164 format
  - `defaultPaymentMethod` string, nullable — The Id of the customer's preferred/default payment method
  - `metadata` object, nullable — use this parameter to attach key-value data to the customer. These will be sent with any associated customer events on your webhooks. You can have a maximum of 5 pieces of metadata.
  - `createdTimestamp` integer — The epoch timestamp (seconds) when the customer was created

## Other responses

- `404` — The given resource could not be found
- `500` — An unexpected error occurred when executing this request

---

[API](https://skmtc.net/ryftpay/apis/ryft-payment-api.md) · [All operations](https://skmtc.net/ryftpay/apis/ryft-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ryftpay/ryft-payment-api/revisions/a042f64d4305/schema)