How to activate a Bearer Token for API access

What is an API?

An API (Application Programming Interface) is a set of rules and protocols that allows different applications to communicate with each other in a structured way.

Put more simply: an API acts as a bridge between two systems, allowing one to request information or execute actions in the other without the need for manual intervention.

For example:

• An application can use an API to automatically create a domain.
• An external system can check the status of a service without accessing the panel directly.

In the case of SWPanel, its API allows managing domains, services, and resources programmatically, facilitating automation and integration with other systems.

What is a Bearer Token?

A Bearer Token is a type of security credential used to authenticate requests to an API.

• It works as a private access key
• It allows identifying the user making the request
• It is sent in each request to the API to authorize the action

Key concept:
Anyone who has access to a Bearer Token can use the API with the permissions associated with that token.

Therefore, it is fundamental:

• Not to share it publicly
• To store it securely
• To revoke it if it is suspected to have been compromised

How does the SWPanel API work and what is it for?

The SWPanel API allows performing the same actions you would normally do from the panel interface, but in an automated way.

This includes, for example:

• Creating or deleting domains
• Managing services
• Automating repetitive tasks
• Integrating SWPanel with external systems (CRM, ERP, proprietary applications, etc.)

It is designed to:

• Reduce manual intervention
• Improve operational efficiency
• Facilitate integrations with other platforms

API Activation

SWPanel has several operating modes. API management is only available in Integrator mode, so you must first activate it.

Activate Integrator mode

1. Access the SWPanel top menu

2. Click on the 'My SWPanel' tab

3. Select 'SWPanel Preferences' or directly 'Change operating mode'

   

4. Access the 'Operation' tab

5. Select the 'Integrator' mode

   

6. Save the changes

7. Return to the Dashboard

8. Click on your avatar to open the top menu

9. Access the 'Integrator Mode' tab

10. Click on 'Activate SWPanel APIs'

    

11. Read the displayed information and accept the activation

    

12. Once the APIs are activated, the Integrator Mode menu will show new options

13. Access the Integrator mode Dashboard

    

14. From the Dashboard, you will be able to see your Bearer Token, access the API documentation, and manage its use

    

Bearer Token Management

SWPanel allows creating and managing multiple Bearer Tokens with different configurations.

This is especially useful for:

• Development teams
• Multiple integrations
• Access control per application

Why use multiple tokens?

• Separate environments (production, development)
• Limit permissions per application
• Revoke access without affecting other systems

How to manage your Bearer Tokens

1. Access the SWPanel top menu

2. Enter the 'Integrator Mode' tab

3. In the 'Manage SWPanel APIs' section, select 'Manage Bearer Tokens'

   

4. View the list of existing tokens

5. Use the available options to create, edit, or revoke tokens

Create a new Bearer Token

1. Click on 'Create new Bearer Token'

   

2. Fill in the required fields:

   • Descriptive name
   • Permissions
   • Security configuration

3. Save the configuration

   

Recommendation:

• Use descriptive names such as:
  • crm-production
  • script-backups
  • billing-integration

Security best practices

1. Do not share your tokens in public code
2. Use different tokens for each integration
3. Revoke tokens that are no longer used
4. Apply the principle of least privilege (only the necessary permissions)

More Integrator Mode options

Integrator mode offers additional tools for working with SWPanel APIs.

Consult the full manual to delve deeper into all its functionalities.

Additional documentation

If you wish, you can consult the specific technical documentation for each of the SWPanel API EndPoints at the following link: Technical documentation

info_capture Note: The screenshots in this manual were taken from version 2026.001.0020 dated 04/27/2026. It may differ from the current version of SWPanel and should simply be taken as guidelines