Ingest Integration Event

This endpoint creates a new integration event. Required parameters include timestamp and the user-defined schema/metadata (attributes).

Device Resolution:

Device identification follows this precedence order:

  1. integration_device_id — if provided, used directly (highest precedence)
  2. device_external_id — if provided, looks up or auto-creates a device with that external ID
  3. Device ID Template — if configured on the event type, evaluates the template against event attributes to derive an external ID, then looks up or auto-creates the device
  4. Error — if none of the above resolve a device, the request fails with 400 Bad Request

There is no fallback between these options. If you provide an invalid integration_device_id, the request fails without trying device_external_id or templates.

For details on configuring Device ID Templates, see the Automatic Device Creation guide.

This endpoint should be used for events forwarded through a webhook. For bulk upload of events, use the Import Integration Events endpoint.

Language
Credentials
Bearer
Click Try It! to start a request and see the response here!