Get a token
Send aPOST request to the authenticate endpoint:
Token lifecycle
TherememberMe field controls how long your token lasts:
When a token expires, request a new one from the same endpoint. There is no refresh token flow; you re-authenticate with credentials.
Using the token
Include the token in theAuthorization header of every API request:
401 Unauthorized response.
Multiple environments
Leaf does not provide separate test and production environments. Instead, create distinct API owner accounts for each:leaf-test@yourcompany.comfor development and testingleaf-prod@yourcompany.comfor production
What to do next
- Authentication API Reference: Endpoint details, request/response shapes, and error codes.
- Quickstart: Use your token to create a Leaf user and start pulling data.
- Core Concepts: Understand the data pipeline before building.

