# How to create API Credentials in WHMCS?

> Create WHMCS API credentials for Phox: add an API role with the allowed actions, then generate the identifier and secret.

Source: https://phox.wdes.org/docs/how-to-create-api-credentials-in-whmcs/
Last updated: 2025-07-07

you can generate unique API authentication credentials. This allows for better management and security for provisioning access to API-connected devices and systems.

1. You can access this feature at **Configuration > System Settings > API Credentials**.

   ![whmcs manage api](https://phox.wdes.org/docs/assets/whmcs-manage-api.Dxhc4h42_YHj2U.webp)
2. Choose the **API Roles** tab > Click **Create API Role** > Enter a role name and description
3. From the Allowed API Actions List choose the desired action for example (Domain > DomainWhois & Products > GetProducts) > Then click on **save**![Vector](https://phox.wdes.org/docs/assets/Vector.C27VI9f0_2aDrC1.webp)

   ![whmcs manage api role](https://phox.wdes.org/docs/assets/whmcs-manage-api-role.DG3Lub-R_ZaTuYz.webp)
4. Choose the **API Credentials** tab > Click **Generate New API Credential** > Select the admin who the new credential will authenticate > Select the desired API roles

   ![whmcs manage credentials](https://phox.wdes.org/docs/assets/whmcs-manage-credentials.0QHFSp9h_jcR2i.webp)
5. Click **Generate**. The system will provide a unique API credential and the credential identifier and secret will display.
6. You must copy the Secret value at this time. If you lose this, you will need to generate a new credential pair.

   ![API Cred generated pair](https://phox.wdes.org/docs/assets/API_Cred_generated_pair.Cz3Bwg1h_1UABvg.webp)