Events API
Track Event
Events API
Track Event
Send events to the Formo Events API
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
JWT Bearer token for authentication. Format: 'Bearer <token>'
Query Parameters
Name of the event pipeline
Body
application/json
Response
200
application/json
Event successfully tracked
The response is of type object
.
Was this page helpful?
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
}