Create a credential
POST https://{{host}}/identity-management/v3/api-clients/:clientId/credentials
This operation creates a new credential for your API client. If you don't know your clientId, you can run the Create your credential operation. Credentials are in active status at creation. By default, they expire two years from their creation date. However, when the API client's permissions are based on Control Center permissions, credentials expire differently and follow the same rotation schedule listed for user passwords on those accounts. Run the Update a credential operation to change the expiration date, description, or status. Save the values from the response, such as the credentialID, for future use. This is the only time you'll see the client secret. Save the credential to avoid the need to create a new one.
Body
PARAM
| Key | Datatype | Required | Description |
accountSwitchKey
|
string | (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys). |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status Created
| {
"clientSecret": "11111111111111111111111111111111111111111111",
"clientToken": "0000-0000000000000000-000000000000000",
"createdOn": "2018-11-01T23:06:59.000Z",
"credentialId": 14111,
"description": "New credential for John.",
"expiresOn": "2020-11-01T23:06:59.000Z",
"status": "ACTIVE"
} |
ENDPOINTS