v1

latestOpenAPI 3.1.0CC-BY-NC-SA-4.02026-07-2413803.8 MB

Profiles API

Update profile

Update an existing profile.

Profiles are required for payment processing. Normally they are created and updated via the Mollie dashboard. Alternatively, you can use this endpoint to automate profile management.

🔑 Access with

Advanced access token with profiles.write

OAuth access with profiles.write

patch/v2/profiles/{profileId}

Request body

namestring nullable

The profile's name, this will usually reflect the trade name or brand name of the profile's website or application.

websitestring nullable

The URL to the profile's website or application. Only https or http URLs are allowed. No @ signs are allowed.

emailstring nullable

The email address associated with the profile's trade name or brand.

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

phonestring nullable

The phone number associated with the profile's trade name or brand.

descriptionstring nullable

The products or services offered by the profile's website or application.

countriesOfActivitystring[] nullable

A list of countries where you expect that the majority of the profile's customers reside, in ISO 3166-1 alpha-2 format.

businessCategorystring nullable

The industry associated with the profile's trade name or brand. Please refer to the business category list for all possible options.

modestring

Updating a profile from test mode to live mode will trigger a verification process, where we review the profile before it can start accepting payments.

Possible values: live test

Example request

{
  "name": "My new website name",
  "website": "https://example.com",
  "email": "test@mollie.com",
  "phone": "+31208202071",
  "description": "My website description",
  "countriesOfActivity": [
    "NL",
    "GB"
  ],
  "businessCategory": "OTHER_MERCHANDISE",
  "mode": "live"
}