Overview
Support Portal provides a comprehensive API that enables programmatic access to workspace data, conversation management, contact operations, and platform configuration. All API requests require authentication via a Personal Access Token. This token uniquely identifies the authenticated user and grants API access scoped to the permissions associated with that user's role.
Operational Objective
Locate and retrieve your Personal Access Token from the Support Portal dashboard to authenticate API requests for integration development, automation workflows, or third-party system connectivity.
Prerequisites
- Administrator privileges on your Support Portal workspace.
Procedure
Step 1: Access Your Profile
Select your avatar in the lower-left corner of the dashboard to open the profile menu.
Step 2: Open Profile Settings
From the profile menu, select Profile Settings to access your profile configuration.
Step 3: Retrieve the Access Token
Scroll to the bottom of the Profile Settings page. The Personal Access Token field displays your token value.
Using Your Access Token
Include the token in the api_access_token parameter or the Authorization header of your API requests:
curl -H "api_access_token: YOUR_TOKEN_HERE" \
https://your-instance.com/api/v1/profile
Security Considerations
Your Personal Access Token provides the same level of access as your authenticated dashboard session. Observe the following security practices:
- Do not share your token publicly or embed it in client-side code.
- Do not commit your token to version control repositories.
- Rotate your token immediately if you suspect it has been compromised.
- Scope access by using tokens associated with accounts that have the minimum required permissions for the integration.
For API documentation and endpoint references, consult the Support Portal API documentation provided by Altores.