Events

Receive tracking event

Receive a tracking event. Authenticate with a secret key (sk_) for server-side calls or a public key (pk_) for the browser tracker. Include an id to make the write idempotent.

post/api/events

Request

  • Base URL: https://dregs.com
  • URL: https://dregs.com/api/events
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

typestring required
dataobject required
keystring
timestampstring date-time
sourcestring
idstring

Optional client-supplied event ID for idempotent ingestion. When provided, repeated posts with the same ID are silently deduplicated against the previous event for the customer. Must not start with "dregs-" and must be at most 64 characters. When omitted, the server generates a dregs-{UUID} identifier.

Example request

{
  "id": "stripe_evt_1Q3abc"
}

Response

Event received successfully

Changes

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