All API endpoints require authentication using either:
  • a SDK Write Key to send events
  • a Query API Read Token to query events
  • a Workspace API Key to manage forms
You’ll need to include the key or token in the request headers for all API calls.

​
SDK Write Key

Tokens in project settings page
Send events with the SDK Write Key in your project settings.

​
Query API Read Token

Query events with the Query API Read Token in your project settings.
Currently available only on request.

​
Request Headers

Include the Token in your request headers: 
Authorization: Bearer <token>

​
Workspace API Key

Find your API key in your workspace settings. This key is unique to your workspace and should be kept secure.
Where to find your Workspace API key

​
Request Headers

API Authentication Flow Diagram
Include the API key in your request headers: 
x-api-key: <your_workspace_api_key>
Call this endpoint with the workspace API key to view your workspace details. 
POST https://api.formo.so/api/validate-api-key