Update customer

Customers API v2
POSThttps://api.mollie.com/v2/customers/*id*

Update an existing customer.

Parameters

Replace id in the endpoint URL by the customer’s ID, for example cst_8wmqcHMN4U.

name
string
optional
The full name of the customer.
email
string
optional
The email address of the customer.
locale
string
optional

Allows you to preset the language to be used in the payment screens shown to the consumer. When this parameter is not provided, the browser language will be used instead in the payment flow (which is usually more accurate).

Possible values: en_US de_AT de_CH de_DE es_ES fr_BE fr_FR nl_BE nl_NL

metadata
object
optional
Provide any data you like in JSON notation, and we will save the data alongside the customer. Whenever you fetch the customer with our API, we’ll also include the metadata. You can use up to 1kB of JSON.

Mollie Connect/OAuth parameters

If you’re creating an app with Mollie Connect/OAuth, the testmode parameter is also available.

testmode
boolean
optional
Set this to true to update a test mode customer.

Response

200 application/hal+json; charset=utf-8

A customer object is returned, as described in Get customer.

Example

Request

1
2
3
curl -X POST https://api.mollie.com/v2/customers/cst_8wmqcHMN4U \
    -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM" \
    -d "{\"name\":\"Updated Customer A\",\"email\":\"updated-customer@example.org\"}"

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
HTTP/1.1 200 OK
Content-Type: application/hal+json; charset=utf-8

{
    "resource": "customer",
    "id": "cst_8wmqcHMN4U",
    "mode": "test",
    "name": "Updated Customer A",
    "email": "updated-customer@example.org",
    "locale": "nl_NL",
    "metadata": null,
    "recentlyUsedMethods": [
        "creditcard",
        "ideal"
    ],
    "createdAt": "2018-04-06T13:23:21.0Z",
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/customers/cst_8wmqcHMN4U",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/customers-api/get-customer",
            "type": "text/html"
        }
    }
}