Skip to main content
POST
/
v0
/
raw_events
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": "1",
    "anonymous_id": "e397c4e7-5f0a-45d6-a06c-f34a809d8b82",
    "user_id": "",
    "address": "",
    "event": "",
    "context": {
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
      "locale": "en-US",
      "timezone": "America/Los_Angeles",
      "location": "US",
      "ref": "",
      "referrer": "",
      "utm_campaign": "",
      "utm_content": "",
      "utm_medium": "",
      "utm_source": "",
      "utm_term": "",
      "page_title": "Dashboard | MyApp",
      "page_url": "https://myapp.com/swap/ethereum#/swap",
      "page_path": "/swap/ethereum",
      "library_name": "Formo Web SDK",
      "library_version": "1.27.0",
      "browser": "chrome",
      "device": "desktop",
      "os": "Windows",
      "screen_width": 1280,
      "screen_height": 720,
      "screen_density": 1.5,
      "viewport_width": 1280,
      "viewport_height": 604
    },
    "properties": {
      "url": "https://myapp.com/swap/ethereum#/swap",
      "path": "/swap/ethereum",
      "hash": "#/swap",
      "query": ""
    },
    "original_timestamp": "2026-04-28T02:08:30.000Z",
    "sent_at": "2026-04-28T02:09:00.000Z",
    "message_id": "263434374239d12b797bf571c6045d6f9f9000a70f19f94d75ca485536606b27"
  }
]
'
{
  "successful_rows": 1,
  "quarantined_rows": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.formo.so/llms.txt

Use this file to discover all available pages before exploring further.

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.
Sending events from the backend? Use the server-side SDK.

Authorizations

​
Authorization
string
header
required

Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API Keys.

Body

application/json
​
type
enum<string>
required
Available options:
page,
connect,
disconnect,
chain,
signature,
transaction,
track,
decoded_log,
detect,
identify
​
channel
enum<string>
required

Source of the event. The Formo Web SDK uses web; mobile SDK uses mobile; server SDK uses server. Use api for direct HTTP submissions and import for backfills.

Available options:
web,
mobile,
server,
api,
import
​
version
string
required

SDK schema version. Web SDK 1.x emits 1; legacy clients emit 0.

Example:

"1"

​
anonymous_id
string
required

Anonymous visitor identifier

​
message_id
string
required

Unique ID for deduplication

​
user_id
string | null

Identified user ID

​
address
string | null

Wallet address

​
event
string | null

Event name (for track events)

​
context
object

Contextual information about the event environment

​
properties
object

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

​
original_timestamp
string<date-time>
​
sent_at
string<date-time>

Response

200 - application/json

Events ingested

​
successful_rows
integer
​
quarantined_rows
integer