{"id":1650,"date":"2022-08-19T13:54:02","date_gmt":"2022-08-19T13:54:02","guid":{"rendered":"https:\/\/pheonixsolutions.com\/knowledge-base\/?p=1650"},"modified":"2026-06-08T16:10:34","modified_gmt":"2026-06-08T16:10:34","slug":"how-to-create-an-api-token-for-a-cpanel-user","status":"publish","type":"post","link":"https:\/\/pheonixsolutions.com\/knowledge-base\/2022\/08\/19\/how-to-create-an-api-token-for-a-cpanel-user\/","title":{"rendered":"How to create an API token for a cPanel user"},"content":{"rendered":"\n

Introduction<\/h2>\n\n\n\n

This guide explains how to generate an API token for an individual cPanel account. The generated token inherits the same permissions and access level as the cPanel user that created it, allowing authenticated access to cPanel API functions without using the account password.<\/p>\n\n\n\n

If you need an API token with customized permissions or restricted access, refer to the documentation linked in the Additional Resources<\/strong> section.<\/p>\n\n\n\n

Generate an API Token via the cPanel Interface<\/h2>\n\n\n\n
    \n
  1. Log in to cPanel using the desired cPanel account.<\/li>\n\n\n\n
  2. Navigate to Manage API Tokens<\/strong>.<\/li>\n\n\n\n
  3. In the Token Name<\/strong> field, enter a descriptive name for the token. This name is used for identification purposes only and can be any value that helps you recognize its intended use.<\/li>\n\n\n\n
  4. Choose an expiration date for the token, or leave the expiration setting disabled if you do not want the token to expire automatically.<\/li>\n\n\n\n
  5. Click Create<\/strong>.<\/li>\n\n\n\n
  6. Copy the generated API token and store it in a secure location.<\/li>\n<\/ol>\n\n\n\n
    \n

    Important:<\/strong> The token value is displayed only once. If it is lost, you will need to revoke the token and create a new one.<\/p>\n<\/blockquote>\n\n\n\n

    Generate an API Token via SSH or Terminal<\/h2>\n\n\n\n
    \n

    Note:<\/strong> This method is currently affected by a known issue and may not function as expected. You can follow updates on the defect using the link provided in the Additional Resources<\/strong> section.<\/p>\n\n\n\n

    Known Issue:<\/strong> UAPI - Tokens::create_full_access requires root access<\/code><\/p>\n<\/blockquote>\n\n\n\n

    Create a Token Without an Expiration Date<\/h3>\n\n\n\n
      \n
    1. Log in to the server via SSH as the cPanel user, or open the Terminal<\/strong> interface within cPanel.<\/li>\n\n\n\n
    2. Run the following command, replacing the username and token name with your own values:<\/li>\n<\/ol>\n\n\n\n
      uapi --user=username Tokens create_full_access name='exampleToken'\n<\/code><\/pre>\n\n\n\n
        \n
      1. Copy the generated token and store it securely.<\/li>\n<\/ol>\n\n\n\n
        Create a Token With an Expiration Date<\/h3>\n\n\n\n
        To create a token that expires after 24 hours, first generate a future Unix epoch timestamp:<\/p>\n\n\n\n
        twentyFourHoursFromNow=$(date +%s -d \"$(date) + 24 Hours\")\n<\/code><\/pre>\n\n\n\n
        Then create the token using the expiration timestamp:<\/p>\n\n\n\n
        uapi --user=username Tokens create_full_access \\\n  name='exampleToken' \\\n  expires_at=$twentyFourHoursFromNow\n<\/code><\/pre>\n\n\n\n
        After the command completes, copy the returned token and store it in a secure location.<\/p>\n\n\n\n
        Security Recommendations<\/h2>\n\n\n\n