An API key is a unique code that connects your Mollie account to a website or integration. Previously listed separately as "API keys" and "Organization access tokens," these are now unified under a single page called API keys in your dashboard.
Store your key immediately when you create it. API keys and access tokens are only shown once, at the moment of creation. After you leave the page, the secret is no longer visible and cannot be retrieved. If you lose access, you will need to rotate your key.
Test and Live API keys
You can use 2 different kinds of API keys: a Test API key and a Live API key:
- Test API key: with this API key, you can test the connection between a website and Mollie. No transaction fees apply.
- Live API key: you can use this API key to process real transactions. Your customers can make actual payments once this key is active.
Where can I find/create the API key?
Currently you can only access API keys page via the
Web App. It is not available
on mobile.
You also need to make sure that you have the right
role
to access this page: only Admin and Developer roles can access it at the moment.
You can create and manage your API keys in your Mollie Web App > in the left navigation menu select Developers > API keys page.
From here, click + Create access token. You'll be asked to choose between the following two types:
- Standard API key – a preconfigured key scoped to a profile, available in Test or Live mode. This is the right choice for most integrations.
- Advanced access token – a custom token where you choose the specific permissions and scope. Use this when you need more granular control (this replaces the former "organization access tokens").
Once you create an API key, you then need to safely store it, since after you exit the page, the keys will no longer be visible in the UI and you can not copy them.
If you lost access to your keys, you need to rotate your keys and save the new keys on creation.
Rotating your API key
You can now create multiple API keys per profile, which makes safe key rotation possible without any downtime:
- Create a second API key for the same profile
- Update your integration to use the new key
- Once you ensure it is working, delete the old key
I changed my website profile. Do I need a new API key?
No, when you make changes to your website profile, you do not need to get a new API key. Your live API key remains valid and the link between your Mollie account and your webshop will remain the same.