To use the TitanX REST APIs, you need an API key. API keys are available for team subscriptions and higher tiers. Only the Team Admin on the company account can generate an API key. If you don’t have an API key or need assistance, please contact our sales team at sales@titanx.io.

​
Generating an API Key

To generate an API key, login to your TitanX Dashboard and navigate to the Acccount page and select the API Keys menu item.

​
Callback URL

If you plan on scoring or enriching contacts, when you generate an API key, you will need to provide a callback URL to return the results of the scoring or enrichment. Check out our Scoring and Enrichment endpoints for more information.

​
Authentication

All API requests require authentication using a Bearer token. The token should contain the API key you generated from your TitanX Dashboard. Include this token in the Authorization header of your HTTP requests. 
curl -X POST https://app.titanx.io/api/scoring \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": {
      "firstName": "Joey",
      "lastName": "Gilkey",
      "email": "example@email.com",
      "phone": "5558675309"
    }
  }'

​
Content Types

The TitanX API always accepts JSON in request bodies and returns JSON in response bodies. You will need to set the Content-Type header to application/json in your request.