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"
    }
  ]
}
'
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.