Update profile

Profiles API v2
PATCHhttps://api.mollie.com/v2/profiles/*id*
Authentication:Organization access tokensApp access tokens

A profile is required to process payments. A profile can easily be created and updated via the Dashboard manually. However, the Mollie API also allows automatic profile creation and updates via the Profiles API.

Parameters

Replace id in the endpoint URL by the profile’s ID, for example pfl_v9hTwCvYqw.

Even though all parameters are optional, at least one of them needs to be provided in the request.

namestringoptional
The profile’s new name.
websitestringoptional
The new URL to the profile’s website or application. The URL should start with https:// or http://.
emailstringoptional
The new email address associated with the profile’s trade name or brand.
phonephone numberoptional
The new phone number associated with the profile’s trade name or brand. Must be in the E.164 format. For example +31208202070.
descriptionstringoptional
The products or services that the profile’s website offers.
countriesOfActivityarrayoptional
The list of countries where you expect that the majority of the profile’s customers will live, in ISO 3166-1 alpha-2 format.
businessCategorystringoptional

The new industry associated with the profile’s trade name or brand.

Refer to the documentation of the business category for more information on which values are accepted.

categoryCodeintegeroptional

Warning

This parameter is deprecated and will be removed in 2022. Use the businessCategory parameter instead.

The new industry identifier associated with the profile’s trade name or brand.

Possible values:

  • 5192 Books, magazines and newspapers
  • 5262 Marketplaces, crowdfunding, donation platforms
  • 5399 General merchandise
  • 5499 Food and drinks
  • 5533 Automotive Products
  • 5641 Children Products
  • 5651 Clothing & Shoes
  • 5712 Home furnishing
  • 5732 Electronics, computers and software
  • 5734 Hosting/VPN services
  • 5735 Entertainment
  • 5815 Credits/vouchers/giftcards
  • 5921 Alcohol
  • 5944 Jewelry & Accessories
  • 5945 Hobby, Toy, and Game Shops
  • 5977 Health & Beauty products
  • 6012 Financial services
  • 6051 Crypto currency
  • 7299 Consultancy
  • 7922 Events, conferences, concerts, tickets
  • 7997 Gyms, membership fee based sports
  • 7999 Travel, rental and transportation
  • 8111 Lawyers and legal advice
  • 8299 Advising/coaching/training
  • 8398 Charity and donations
  • 8699 Political parties
  • 9399 Government services
  • 0 Other
modestringoptional

The new profile mode. Note switching from test to production mode will trigger a verification process where we review the profile.

Possible values: live test

Response

200 application/hal+json

The updated profile object is returned, as described in Get profile.

Example

cURLPHPPythonRubyNode.js
1
2
3
4
5
6
7
curl -X PATCH https://api.mollie.com/v2/profiles/pfl_v9hTwCvYqw \
   -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ" \
   -d "name=My website name - Update 1" \
   -d "website=https://www.mywebsite2.com" \
   -d "email=info@mywebsite2.com" \
   -d "phone=+31208202070" \
   -d "businessCategory=OTHER_MERCHANDISE"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
<?php
$mollie = new \Mollie\Api\MollieApiClient();
$mollie->setAccessToken("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ");

$profileId = "pfl_v9hTwCvYqw";
$mollie->profiles->update($profileId, [
  "name" => "My website name - Update 1",
  "website" => "https://www.mywebsite2.com",
  "email" => "info@mywebsite2.com",
  "phone" => "+31208202070",
  "businessCategory" => "OTHER_MERCHANDISE",
]);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
from mollie.api.client import Client

mollie_client = Client()
mollie_client.set_access_token("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ")

profile = mollie_client.profiles.update(
    "pfl_v9hTwCvYqw", {
        "name": "My website name - Update 1",
        "website": "https://www.mywebsite2.com",
        "email": "info@mywebsite2.com",
        "phone": "+31208202070",
        "businessCategory": "OTHER_MERCHANDISE",
    }
)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
require 'mollie-api-ruby'

Mollie::Client.configure do |config|
  config.api_key = 'access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ'
end

profile = Mollie::Profile.update(
  'pfl_v9hTwCvYqw',
  name: 'My website name - Update 1',
  website: 'https://www.mywebsite2.com',
  email: 'info@mywebsite2.com',
  phone: '+31208202070',
  businessCategory: 'OTHER_MERCHANDISE'
)

1
2
3
4
We don't have a Node.js code example for this API call yet.

If you have some time to spare, feel free to share suggestions on our Discord:
https://discord.gg/VaTVkXB4aQ

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
HTTP/1.1 200 OK
Content-Type: application/hal+json

{
    "resource": "profile",
    "id": "pfl_v9hTwCvYqw",
    "mode": "live",
    "name": "My website name - Update 1",
    "website": "https://www.mywebsite2.com",
    "email": "info@mywebsite2.com",
    "phone": "+31208202070",
    "businessCategory": "OTHER_MERCHANDISE",
    "categoryCode": 5399,
    "status": "verified",
    "review": {
        "status": "pending"
    },
    "createdAt": "2018-03-20T09:28:37+00:00",
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/profiles/pfl_v9hTwCvYqw",
            "type": "application/hal+json"
        },
        "dashboard": {
            "href": "https://www.mollie.com/dashboard/org_123456789/settings/profiles/pfl_v9hTwCvYqw",
            "type": "text/html"
        },
        "chargebacks": {
            "href": "https://api.mollie.com/v2/chargebacks?profileId=pfl_v9hTwCvYqw",
            "type": "application/hal+json"
        },
        "methods": {
            "href": "https://api.mollie.com/v2/methods?profileId=pfl_v9hTwCvYqw",
            "type": "application/hal+json"
        },
        "payments": {
            "href": "https://api.mollie.com/v2/payments?profileId=pfl_v9hTwCvYqw",
            "type": "application/hal+json"
        },
        "refunds": {
            "href": "https://api.mollie.com/v2/refunds?profileId=pfl_v9hTwCvYqw",
            "type": "application/hal+json"
        },
        "checkoutPreviewUrl": {
            "href": "https://www.mollie.com/payscreen/preview/pfl_v9hTwCvYqw",
            "type": "text/html"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/profiles-api/create-profile",
            "type": "text/html"
        }
    }
}