Skip to main content
All API endpoints require authentication using either:
  • a SDK Write Key to send 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

Find your SDK Write Key in your project settings.
Tokens in project settings page
Send events through the Events API or SDKs with the SDK Write Key.

​
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
The API Key must include the correct Read / Write scope for the API you are calling.

​
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