Update customer

patch

https://api.mollie.com/v2/customers/{customerId}

Update an existing customer.

For an in-depth explanation of each parameter, refer to the Create customer endpoint.

Access with

API key

Organization access token with customers.write

OAuth access with customers.write

Path Params

customerId

string

required

Provide the ID of the related customer.

Body Params

name

string | null

The full name of the customer.

string | null

The email address of the customer.

If the domain contains non-ASCII characters, encode it as Punycode per RFC 3492.

locale

string | null

Preconfigure the language to be used in the hosted payment pages shown to the customer. Should only be provided if absolutely necessary. If not provided, the browser language will be used which is typically highly accurate.

Possible values: en_US en_GB nl_NL nl_BE de_DE de_AT de_CH fr_FR fr_BE es_ES ca_ES pt_PT it_IT nb_NO sv_SE fi_FI da_DK is_IS hu_HU pl_PL lv_LV lt_LT null

metadata

Provide any data you like, for example a string or a JSON object. We will save the data alongside the entity. Whenever you fetch the entity with our API, we will also include the metadata. You can use up to approximately 1kB.

testmode

boolean

Whether the entity was created in test mode or live mode. This field does not update the mode of the entity.

Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting testmode to true.

Responses

Language

Credentials

Request

Response

Choose an example:

application/hal+json

200The updated customer object.

404No entity with this ID exists.