Getting Started

Authentication

Updated: July 4, 2025

The FireTail API uses JWT tokens obtained through OAuth 2.0 client credentials flow. Client credentials can be managed through your FireTail organization settings.

Note: Keep your client credentials secure and never share them in publicly accessible areas such as GitHub repositories or client-side code.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Obtaining an access token

$ curl -X POST \
  https://api.saas.eu-west-1.prod.firetail.app \
  -d grant_type=client_credentials -d client_id={CLIENT_ID} -d client_secret={CLIENT_SECRET}

Python example

import requests
url = 'https://api.saas.eu-west-1.prod.firetail.app/oauth/token'
payload = {
    'grant_type': 'client_credentials',
    'client_id': 'YOUR_CLIENT_ID',
    'client_secret': 'YOUR_CLIENT_SECRET'
}
headers = {
    'Content-Type': 'application/x-www-form-urlencoded'
}
response = requests.post(url, data=payload, headers=headers)
access_token = response.json().get('access_token')

Response format

{
  "access_token": "xyz",
  "expires_in": 3600,
}