Altrata - How do I link my account?
Overview
To authenticate with Altrata, you will need:
- Service Hostname β The Altrata service hostname to connect to.
- API Key β Your Altrata API key.
- Username β Your Altrata Service User username.
- Password β Your Altrata Service User password.
Tenklo uses the API Key, Username, and Password to exchange for a JWT (8-hour TTL) via the Altrata auth endpoint and handles token refresh automatically.
Prerequisites
- An active Altrata subscription with API access.
Step 1: Obtain your credentials
Your Service User credentials and API key are sent to you by email during subscription setup. You will receive:
- API Key β provided as part of your Altrata Salesforce app access.
- Username and Password β your Service User account details.
If you have not received these, contact your Client Success representative or email [email protected].
Step 2: Choose a service hostname
Altrata exposes four GraphQL services. Choose the hostname that matches your use case and enter it in the Service Hostname field:
| Service | Hostname |
|---|---|
| Matching | matching.altrata.com |
| Profile | profile.altrata.com |
| Events | events.altrata.com |
| Relationships | relationships.altrata.com |
Step 3: Enter credentials in the Connect UI
- Open the form where you need to authenticate with Altrata.
- Enter your Service Hostname, API Key, Username, and Password in their designated fields.
- Submit the form, and you should be successfully authenticated.
You are now connected to Altrata.