Events

Ingest events

Send analytics events to Formo. This endpoint runs on events.formo.so (not api.formo.so). Authenticate with your project's SDK write key.

post/v0/raw_events

Request

  • Base URL: https://events.formo.so
  • URL: https://events.formo.so/v0/raw_events
  • Auth: HTTP bearer

Request body

type'page' | 'connect' | 'disconnect' | 'chain' | 'signature' | 'transaction' | 'track' | 'decoded_log' | 'detect' | 'identify' | 'web_vitals' required
channel'web' | 'mobile' | 'server' | 'api' | 'import' 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.

versionstring required

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

anonymous_idstring required

Anonymous visitor identifier

user_idstring nullable

Identified user ID

addressstring nullable

Wallet address

eventstring nullable

Event name (for track events)

propertiesEventProperties

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

original_timestampstring date-time
sent_atstring date-time
message_idstring

Unique ID for deduplication. Optional; a UUID is generated server-side when omitted.

Example request

[
  {
    "version": "1"
  }
]

Response

Batch accepted. The body carries an ingestion summary when one is available, otherwise {}.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.