Create business account

post

https://api.mollie.com/v2/business-accounts/accounts

🔒
Restricted access
This API is currently only available to Mollie's authorized partners via OAuth. Direct access for individual businesses isn't available yet, but it's on our roadmap — check back here for updates.

Create a new business account for the authenticated organization.

The response contains the newly created business account.

Each organization can have up to 5 active business accounts. Need more? Contact us and we'll help you out.

🔑
Access with
OAuth access with business-accounts.write

Body Params

name

string

required

length between 1 and 80

The name of the business account, as shown to the account holder.

currency

string

required

The currency of the business account, as an ISO 4217 currency code.

Only EUR is supported for now. We're working on more currencies, and they'll be available soon.

Possible values: EUR

Show Details

EUR

Euro

testmode

boolean

Whether to create the entity in test mode or live mode.

You can enable test mode by setting testmode to true.

Headers

Idempotency-Key

string

A unique value that identifies this request, so you can safely retry it without creating a second account. Retrying with the same key within one hour returns the original response. We recommend a UUIDv4.

Keys are tied to the credential that sent the original request, so a refreshed OAuth token won't match earlier keys. View the public documentation to learn more.

Responses

Language

Credentials

OAuth2

Loading…

Response

Choose an example:

application/hal+json

201The newly created business account object.

400The request is malformed. For example, the body isn't valid JSON, a required field such as name is missing, or the Idempotency-Key was already used for a request with different parameters.

409Your organization already has a business account with this name, or a request with the same Idempotency-Key is still being processed.

422The request is well-formed, but Mollie can't create the account. For example, your organization already has 5 active business accounts, the maximum allowed. Contact us if you need more.

429Rate Limit has been reached.