Skip to main content
POST
/
v0
/
raw_events
Track Event
curl --request POST \
  --url https://events.formo.so/v0/raw_events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "page",
  "channel": "web",
  "version": "0",
  "anonymous_id": "c2bc0ebe-d852-49d1-9efd-e45744850ae0",
  "user_id": "a46e6878-1ed5-4a81-9185-83608df2fcb6",
  "address": "0x9CC3cB28cd94eB4423B15cdA73346e204f59a407",
  "event": "",
  "context": {
    "user_agent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
    "locale": "en-GB",
    "timezone": "Africa/Lagos",
    "location": "NG",
    "ref": "",
    "referrer": "",
    "utm_campaign": "",
    "utm_content": "",
    "utm_medium": "",
    "utm_source": "",
    "utm_term": "",
    "page_title": "WalletConnect Content Cabal",
    "page_url": "https://app.formo.so/lByfTbeUSL_mxy_TN2m3d",
    "library_name": "Formo Web SDK",
    "library_version": "1.25.0",
    "browser": "chrome",
    "screen_width": 393,
    "screen_height": 873,
    "screen_density": 2.75,
    "viewport_width": 392,
    "viewport_height": 735
  },
  "properties": {
    "url": "https://app.formo.so/lByfTbeUSL_mxy_TN2m3d",
    "path": "/lByfTbeUSL_mxy_TN2m3d",
    "hash": "",
    "query": ""
  },
  "original_timestamp": "2025-04-23T13:15:17.000Z",
  "sent_at": "2025-04-23T13:15:18.000Z",
  "message_id": "48555101eee2f44ac0f0632fcb7c7c9f6ce0012ae395ae79f8a0d515e4f5e41f"
}
'
{
  "successful_rows": 1,
  "quarantined_rows": 0
}
Send events to Formo from any source. Sending custom events? See the event specs.
This endpoint is hosted on events.formo.so, a separate service from the main API at api.formo.so.

Authorizations

​
Authorization
string
header
required

Bearer token for authentication. Use an SDK Write Key for the Events API, or a Workspace API Key for the Query and Profile APIs. Format: 'Bearer '

Body

application/json
​
type
enum<string>

Type of the event

Available options:
identify,
track,
page,
connect,
disconnect,
detect,
chain,
signature,
transaction
​
channel
enum<string>

Channel/source of the event

Available options:
web,
mobile,
server
​
version
string

Event spec version

​
anonymous_id
string

Pseudo-identifier for the user (device ID)

​
user_id
string | null

Unique user identifier

​
address
string | null

Wallet address

​
event
string

Name of the event (for track events)

​
context
object

Contextual information about the event

​
properties
object

Event-specific properties. Can contain any key-value pairs relevant to the event.

​
original_timestamp
string<date-time>

Time when the event occurred on the client

​
sent_at
string<date-time>

Time when the event was sent from the client

​
message_id
string

Unique identifier for the event

Response

Event successfully tracked

​
successful_rows
integer

Number of events successfully ingested

Example:

1

​
quarantined_rows
integer

Number of events that failed validation and were quarantined

Example:

0