---
title: "Create profile"
method: POST
path: "/v2/profiles"
tags: ["Profiles API"]
---

# Create profile

`POST /v2/profiles`

Create a profile to process payments on.

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

> 🔑 Access with
>
> [Advanced access token with **profiles.write**](/reference/authentication)
>
> [OAuth access with **profiles.write**](/reference/authentication)

## Request body

- object
  - `resource` string — Indicates the response contains a profile object. Will always contain the string `profile` for this endpoint.
  - `id` string — The identifier uniquely referring to this profile. Example: `pfl_v9hTwCvYqw`.
  - `mode` string — Whether this entity was created in live mode or in test mode. Possible values: `live` `test`
  - `name` string, required — The profile's name, this will usually reflect the trade name or brand name of the profile's website or application.
  - `website` string, required — The URL to the profile's website or application. Only `https` or `http` URLs are allowed. No `@` signs are allowed.
  - `email` string, required — 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](https://www.rfc-editor.org/rfc/rfc3492).
  - `phone` string, required — The phone number associated with the profile's trade name or brand.
  - `description` string — The products or services offered by the profile's website or application.
  - `countriesOfActivity` string[] — A list of countries where you expect that the majority of the profile's customers reside, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
  - `businessCategory` string, nullable — The industry associated with the profile's trade name or brand. Please refer to the [business category list](common-data-types#business-category) for all possible options.
  - `status` string — The profile status determines whether the profile is able to receive live payments. * `unverified`: The profile has not been verified yet and can only be used to create test payments. * `verified`: The profile has been verified and can be used to create live payments and test payments. * `blocked`: The profile is blocked and can no longer be used or changed. Possible values: `unverified` `verified` `blocked`
  - `review` object — Present if changes have been made that have not yet been approved by Mollie. Changes to test profiles are approved automatically, unless a switch to a live profile has been requested. The review object will therefore usually be `null` in test mode.
    - `status` string — The status of the requested changes. Possible values: `pending` `rejected`
  - `createdAt` string — The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `_links` object — An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
    - `self` object — In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `dashboard` object — Link to the profile in the Mollie dashboard.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `chargebacks` object — The API resource URL of the chargebacks that belong to this profile.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `methods` object — The API resource URL of the methods that are enabled for this profile.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `payments` object — The API resource URL of the payments that belong to this profile.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `refunds` object — The API resource URL of the refunds that belong to this profile.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `checkoutPreviewUrl` object — The hosted checkout preview URL. You need to be logged in to access this page.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.
    - `documentation` object — In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required — The actual URL string.
      - `type` string, required — The content type of the page or endpoint the URL points to.

## Other responses

- `403` — Profile limit has been reached for demo accounts.
- `422` — The request contains issues. For example, if a profile name is missing or website URL is invalid.
- `429` — Rate Limit has been reached.

---

[API](https://skmtc.net/mollie/apis/accepting-payments.md) · [All operations](https://skmtc.net/mollie/apis/accepting-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/accepting-payments/revisions/4b45df3039ef/schema)
