# IAM credentials

Source: https://developer.nylas.com/docs/reference/api/iam-credentials/

Create and manage IAM credentials of type `api_key` attached to principals. Credentials inherit the principal's policy, and creation returns the secret only once. Requests require an organization-bound IAM API key with the corresponding `iam.credentials.*` permission. See [credential creation and rotation](/docs/v3/auth/nylas-iam/manage-principals-with-api/#create-an-iam-credential).


## Endpoints

- **GET** `/v3/iam/principals/{principal_id}/credentials` - [List IAM credentials](https://developer.nylas.com/docs/reference/api/iam-credentials/list-iam-credentials/)
- **POST** `/v3/iam/principals/{principal_id}/credentials` - [Create IAM credential](https://developer.nylas.com/docs/reference/api/iam-credentials/create-iam-credential/)
- **GET** `/v3/iam/principals/{principal_id}/credentials/{credential_id}` - [Get IAM credential](https://developer.nylas.com/docs/reference/api/iam-credentials/get-iam-credential/)
- **PATCH** `/v3/iam/principals/{principal_id}/credentials/{credential_id}` - [Update IAM credential](https://developer.nylas.com/docs/reference/api/iam-credentials/update-iam-credential/)
- **DELETE** `/v3/iam/principals/{principal_id}/credentials/{credential_id}` - [Delete IAM credential](https://developer.nylas.com/docs/reference/api/iam-credentials/delete-iam-credential/)