Create profile
Profiles API

POST
https://api.mollie.nl/v1/profiles
Authentication: OAuth access tokens

In order to process payments, you need a website profile, so Mollie knows who the payment is for. A website profile can easily be created manually. However, certain business models need a way to automate profile creation. The Profiles API helps in automating these processes.

Since each profile needs a set of API keys to communicate with Mollie, endpoints for API key management are available in this API as well.

Parameters

name
string

The profile's name should reflect the tradename or brand name of the profile's website or application.

website
string

The URL to the profile's website or application. The URL should start with http:// or https://.

email
string

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

phone
string

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

categoryCode
integer

The industry associated with the profile's tradename or brand.

Possible values:

  • 5399 General merchandise
  • 5732 Electronics, computers, and software
  • 4121 Travel, rental, and transportation
  • 6012 Financial services
  • 5499 Food and drinks
  • 7999 Events, festivals, and recreation
  • 5192 Books, magazines, and newspapers
  • 7299 Personal services
  • 8398 Charity and donations
  • 0 Other
mode
string

Optional – Creating a test profile by setting this parameter to test, enables you to start using the API without having to provide all your business info just yet. Defaults to live.

Possible values: live test

Includes

Some endpoints allow you to indicate if you want more information to be included in the API response via the include querystring parameter.

  • No includes supported for this endpoint.

Response

201
application/json; charset=utf-8

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

Example

Request code

// Not implemented. Create a pull request: https://github.com/mollie/mollie-api-php

Response

HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8

{
    "resource": "profile",
    "id": "pfl_v9hTwCvYqw",
    "mode": "live",
    "name": "My website name",
    "website": "https://www.mywebsite.com",
    "email": "info@mywebsite.com",
    "phone": "31123456789",
    "categoryCode": 5399,
    "status": "unverified",
    "review": {
        "status": "pending"
    },
    "createdDatetime": "2017-12-12T21:55:45.0Z",
    "updatedDatetime": "2017-12-12T23:21:24.0Z",
    "links": {
        "apikeys": "https://api.mollie.nl/v1/profiles/pfl_v9hTwCvYqw/apikeys"
    }
}