---
title: "Submit onboarding data"
method: POST
path: "/v2/onboarding/me"
tags: ["Onboarding API"]
---

# Submit onboarding data

`POST /v2/onboarding/me`

**⚠️ We no longer recommend implementing this endpoint. Please refer to the Client Links API instead to kick off the
onboarding process for your merchants.**

Submit data that will be prefilled in the merchant's onboarding. The data you submit will only be processed when the
onboarding status is `needs-data`.  
Information that the merchant has entered in their dashboard will not be overwritten.

## Headers

- `idempotency-key` string

## Request body

- object
  - `organization` object
    - `name` string — The name of the organization.
    - `address` Address
      - `streetAndNumber` string, required — A street and street number.
      - `postalCode` string, required — A postal code. This field may be required if the provided country has a postal code system.
      - `city` string, required
      - `country` string, required — A country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `registrationNumber` string — The registration number of the organization at their local chamber of commerce.
    - `vatNumber` string, nullable — The VAT number of the organization, if based in the European Union or in The United Kingdom. VAT numbers are verified against the international registry *VIES*. The field can be omitted for merchants residing in other countries.
    - `vatRegulation` 'dutch' | 'british' | 'shifted', nullable — Mollie applies Dutch VAT for merchants based in The Netherlands, British VAT for merchants based in The United Kingdom, and shifted VAT for merchants in the European Union. The field can be omitted for merchants residing in other countries.
  - `profile` object
    - `name` string — The profile's name, this will usually reflect the trade name or brand name of the profile's website or application.
    - `url` string — The URL to the profile's website or application. Only `https` or `http` URLs are allowed. No `@` signs are allowed.
    - `email` string — 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 — The phone number associated with the profile's trade name or brand.
    - `description` string, nullable — The products or services offered by the profile's website or application.
    - `businessCategory` string — The industry associated with the profile's trade name or brand. Please refer to the [business category list](common-data-types) for all possible options.

## Response `204`

An empty response.

## Other responses

- `429` — Rate Limit has been reached.

---

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