Authentication

All calls to the Felt API authenticate with a personal access token sent as a Bearer token in the request header:

Authorization: Bearer <API Token>

Tokens start with the felt_pat_ prefix. Since a token grants access to your account, store it securely — treat it like a password. Prefer environment variables or a secrets manager over hardcoding tokens in source code.

Creating a token

You can create an API token in the Developers tab of the Workspace Settings page:

Generate as many API tokens as you need

Give your API token a unique name

Make sure to copy your token to a secure location

Be sure to take note of the token before closing the dialog; you won't have a second chance to view it. Only a hash of your token is stored on Felt's servers.

How tokens behave

• Workspace-scoped. Each token belongs to the workspace it was created in and can only access that workspace's resources. Requests against another workspace's resources fail with 401.

• They act as you. Requests made with your token have your account's permissions in that workspace.

• No expiry. Tokens remain valid until revoked. To rotate a token, create a new one in workspace settings, switch your integration over, and revoke the old one.

• Failed authentication returns 401 with a JSON body explaining the problem — see Errors and rate limits.

Making an authenticated request

curl

# This looks like:
# FELT_API_TOKEN="felt_pat_ABCDEFUDQPAGGNBmX40YNhkCRvvLI3f8/BCwD/g8"
FELT_API_TOKEN="<YOUR_API_TOKEN>"

curl \
  -H "Authorization: Bearer ${FELT_API_TOKEN}" \
  "https://felt.com/api/v2/user"

Python

import requests

# This looks like:
# api_token = "felt_pat_ABCDEFUDQPAGGNBmX40YNhkCRvvLI3f8/BCwD/g8"
api_token = "<YOUR_API_TOKEN>"

r = requests.get(
  "https://felt.com/api/v2/user",
  headers={"Authorization": f"Bearer {api_token}"}
)
assert r.ok
print(r.json())

A successful response returns your user details, confirming the token works:

{
  "id": "AbC123dEfG456hIjK789lM",
  "type": "user",
  "name": "Your Name",
  "email": "[e-mail]"
}

From here, head to Getting started to create your first map via the API.