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

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.

​
Request Headers

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