Skip to main content
POST
/
v0
/
events
Track Event
curl --request POST \
  --url https://events.formo.so/v0/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "channel": "web",
  "type": "page",
  "anonymous_id": "c2bc0ebe-d852-49d1-9efd-e45744850ae0",
  "user_id": "a46e6878-1ed5-4a81-9185-83608df2fcb6",
  "address": "0x9CC3cB28cd94eB4423B15cdA73346e204f59a407",
  "event": "",
  "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": "0",
  "original_timestamp": "2025-04-23T13:15:17.000Z",
  "sent_at": "2025-04-23T13:15:18.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
​
channel
string
required

Channel of the event

​
type
string
required

Type of the event

​
anonymous_id
string
required

Anonymous user identifier

​
user_id
string
required

User identifier

​
address
string
required

Wallet address

​
event
string
required

Name of the event

​
context
string
required

Event context as JSON string

​
properties
string
required

Event properties as JSON string

​
version
string
required

Event version

​
original_timestamp
string<date-time>
required

Original timestamp of the event

​
sent_at
string<date-time>
required

Timestamp when the event was sent

​
message_id
string
required

Unique message identifier

Response

Event successfully tracked

​
success
boolean
Example:

true

⌘I