Create an API credential
Creates an API credential for the company account identified in the path. In the request, you can specify the roles and allowed origins for the new API credential.
The response includes the:
- API key: used for API request authentication.
- Client key: public key used for client-side authentication.
- Username and password: used for basic authentication.
Make sure you store the API key securely in your system. You won't be able to retrieve it later.
If your API key is lost or compromised, you need to generate a new API key.
To make this request, your API credential must have the following roles:
- Management API—API credentials read and write
In: header
Path Parameters
The unique identifier of the merchant account.
Request Body
application/json
The list of allowed origins for the new API credential.
Description of the API credential.
List of roles for the API credential. Only roles assigned to 'ws@Company.' can be assigned to other API credentials.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/merchants/string/apiCredentials" \ -H "Content-Type: application/json" \ -d '{ "roles": [ "Checkout webservice role" ], "allowedOrigins": [ "https://www.mystore.com" ] }'Example response for adding an API credential.
{ "id": "YOUR_API_CREDENTIAL", "username": "YOUR_USERNAME", "clientKey": "YOUR_CLIENT_KEY", "allowedIpAddresses": [], "roles": [ "Checkout webservice role" ], "active": true, "allowedOrigins": [ { "id": "YOUR_ALLOWED_ORIGIN", "domain": "https://www.mystore.com", "_links": { "self": { "href": "https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins/YOUR_ALLOWED_ORIGIN" } } } ], "_links": { "self": { "href": "https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL" }, "allowedOrigins": { "href": "https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/allowedOrigins" }, "generateApiKey": { "href": "https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateApiKey" }, "generateClientKey": { "href": "https://management-test.adyen.com/v1/companies/YOUR_COMPANY_ACCOUNT/apiCredentials/YOUR_API_CREDENTIAL/generateClientKey" }, "merchant": { "href": "https://management-test.adyen.com/v1/merchants/YOUR_MERCHANT_ACCOUNT" } }, "apiKey": "YOUR_API_KEY", "password": "YOUR_PASSWORD"}Get a list of API credentials GET
Returns the list of [API credentials](https://docs.adyen.com/development-resources/api-credentials) for the merchant account. The list is grouped into pages as defined by the query parameters. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write
Get an API credential GET
Returns the [API credential](https://docs.adyen.com/development-resources/api-credentials) identified in the path. To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—API credentials read and write