Skip to main content
POST
/
events
Create one or more events. Requires public API key in Bearer token.
curl --request POST \
  --url https://api.trench.dev/events \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "anonymousId": "guest-1234567890",
      "event": "UserSignedUp",
      "timestamp": "2021-01-01T00:00:00Z",
      "type": "track",
      "userId": "user-1234567890",
      "groupId": "group-1234567890",
      "properties": {
        "page": "/home",
        "referrer": "https://www.google.com"
      },
      "traits": {
        "email": "john.doe@example.com",
        "name": "John Doe"
      },
      "instanceId": "customer-1234567890"
    }
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.trench.dev/llms.txt

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

This endpoint requires your public API key.
Trench is fully compatible with the Segment Spec schema. You can use the track, identify, and group methods to send events to Trench via the /events endpoint.

Body

application/json
​
events
object[]
required

The events to insert.

Response

201

The events have been successfully created.