Batch Track Events

Record up to 200 custom events in a single request. Each event is processed independently.

The response includes summary counts and a per-event error list for any failures. Partial failures do not cause the entire request to fail.

post/v2/events/batch

Request

Base URL
https://pub-api.conversion.ai/api
Auth
- API key in header X-API-Key
- or API key in query parameter api_key

Request body

createContactsboolean

When true, creates the contact for every event in the batch whose userId or email matches no existing contact. Creating a contact requires an email.

Example request

{
  "events": [
    {
      "userId": "user_12345",
      "email": "jane@example.com",
      "event": "log_in",
      "eventId": "evt_abc123"
    }
  ],
  "createContacts": true
}

Response

Batch processed. Check errors for individual failures.

Changes

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