Update profile

Profiles API v2
PATCHhttps://api.mollie.com/v2/profiles/*id*

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.

name

string
required
The profile’s new name.

website

string
required
The new URL to the profile’s website or application. The URL should start with https:// or http://.

email

string
required
The new email address associated with the profile’s trade name or brand.

phone

phone number
required
The new phone number associated with the profile’s trade name or brand. Must be in the E.164 format. For example +31208202070.

categoryCode

integer
optional

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

Possible values:

  • 4121 Travel, rental and transportation
  • 5192 Books, magazines and newspapers
  • 5399 General merchandise
  • 5499 Food and drinks
  • 5533 Automotive Products
  • 5641 Children Products
  • 5651 Clothing & Shoes
  • 5732 Electronics, computers and software
  • 5735 Entertainment
  • 5815 Digital services
  • 5944 Jewelry & Accessories
  • 5977 Health & Beauty products
  • 6012 Financial services
  • 7299 Personal services
  • 7999 Events, festivals and recreation
  • 8398 Charity and donations
  • 0 Other

mode

string
optional

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 "categoryCode=5399"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<?php
$mollie = new \Mollie\Api\MollieApiClient();
$mollie->setAccessToken("access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ");
$profile = $mollie->profiles->get("pfl_v9hTwCvYqw");

$profile->name = "My website name - Update 1";
$profile->website = "https://www.mywebsite2.com";
$profile->email = "info@mywebsite2.com";
$profile->phone = "+31208202070";
$profile->categoryCode = "5399";
$updatedProfile = $profile->update();
1
2
3
4
We don't have a Python code example for this API call yet.

If you have some time to spare, feel free to open a pull request at:
https://github.com/mollie/api-documentation
1
2
3
4
We don't have a Ruby code example for this API call yet.

If you have some time to spare, feel free to open a pull request at:
https://github.com/mollie/api-documentation
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 open a pull request at:
https://github.com/mollie/api-documentation

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
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",
    "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"
        },
        "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"
        }
    }
}