POST
/
v0
/
events
curl --request POST \
  --url https://events.formo.so/v0/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "test-project-id",
  "session_id": "b6035b24-3fcb-4089-8cdd-a26d53f8f1b5",
  "channel": "web",
  "type": "page",
  "anonymous_id": "c2bc0ebe-d852-49d1-9efd-e45744850ae0",
  "user_id": "a46e6878-1ed5-4a81-9185-83608df2fcb6",
  "address": "0x9CC3cB28cd94eB4423B15cdA73346e204f59a407",
  "event": "page_hit",
  "context": "{\"user_agent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36\",\"locale\":\"en-US\",\"location\":\"ID\",\"timezone\":\"Asia/Saigon\",\"referrer\":\"https://chatgpt.com/\",\"utm_source\":\"chatgpt.com\",\"utm_medium\":\"linkedin\",\"utm_campaign\":\"early-access\",\"utm_term\":null,\"utm_content\":null,\"ref\":\"vitalik.eth\",\"page_url\":\"https://www.estore.com/best-seller/1\",\"page_path\":\"/best-seller/1\",\"page_title\":\"The best sellers offered by EStore\",\"library_name\":\"Formo Web SDK\",\"library_version\":\"1.16.2\"}",
  "properties": "{\"name\":\"Best Seller\",\"category\":\"Docs\",\"url\":\"https://formo.so/faucets?utm_source=chatgpt.com\",\"path\":\"/best-seller/1\",\"hash\":\"#submit\",\"title\":\"The best sellers offered by EStore\"}",
  "version": "1",
  "original_timestamp": "2025-04-23T13:15:17.000Z",
  "sent_at": "2025-04-23T13:15:18.000Z",
  "received_at": "2025-04-23T13:15:00.000Z",
  "message_id": "48555101eee2f44ac0f0632fcb7c7c9f6ce0012ae395ae79f8a0d515e4f5e41f"
}'
{
  "success": true
}

Send events to the Formo Events API for tracking user actions.

Authorizations

​
Authorization
string
header
required

JWT Bearer token for authentication. Format: 'Bearer <token>'

Query Parameters

​
name
string
default:raw_events
required

Name of the event pipeline

Body

application/json

Response

200
application/json

Event successfully tracked

The response is of type object.