Events

Track events in bulk

Records up to 100 events, for one or more existing contacts. Each event is checked on its own: problems are listed per index in errors and the other events are still recorded. The whole request fails only on a malformed body (400), a disabled feature (403) or a limit (429).

POST

/v2/events/bulk

curl --request POST \
  --url https://do.featurebase.app/v2/events/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "contact": {
        "email": "jane@example.com",
        "id": "67ec1234abcd5678ef901234",
        "userId": "user_42"
      },
      "createdAt": "2026-10-05T10:00:00Z",
      "id": "evt_01J9Z3",
      "metadata": {
        "plan": "pro",
        "price": {
          "amount": 3499,
          "currency": "EUR"
        },
        "seats": 12
      },
      "name": "updated-plan"
    }
  ]
}
'

{
  "accepted": 123,
  "archived": 123,
  "duplicates": 123,
  "errors": [
    {
      "code": "metadata_invalid",
      "index": 123,
      "message": "<string>",
      "param": "metadata.plan"
    }
  ],
  "limitReached": 123,
  "object": "event_receipt"
}

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Body

eventsobject[]required

Up to 100 events. Contacts may differ per event.

Required array length: 1 - 100

Show child attributes

Response

Success

acceptedintegerrequired

Events recorded.

archivedintegerrequired

Events ignored because their event name is archived.

duplicatesintegerrequired

Events ignored because the same event was already recorded (same id, or same contact, name and createdAt).

errorsobject[]required

Show child attributes

limitReachedintegerrequired

Events ignored because the workspace reached its limit of active event names, or of all event names (archived included).

objectenum<string>required

Available options: event_receipt

Still need help? Ask the team