Create organization API credentials
Creates new API credentials for an organization with the following validations:
-
Organization Validation:
- Organization must exist
- User must have access to the organization
-
Role Assignment (required):
- At least one role must be provided
- Roles will be assigned to the API credentials for the organization
- Roles must be valid organization roles (not merchant roles)
- Invalid or missing roles will result in a 400 error
-
Permission Requirements:
- User must have MERCHANT_DEV_SETTINGS_CREATE_API_KEY permission
Path parameters
organizationId
Organization ID
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
API credentials information to create
name
Descriptive name to identify the purpose of the API credentials
roles
Array of role IDs or names to assign to the API credentials for the merchant. Must contain at least 1 role.
Response
Organization API credentials created successfully
apiKey
Generated API Key for the merchant
secret
Generated Secret for the merchant