Model: EventsBatchSubmitV1

1 min

Model Parameters

EventsBatchSubmitV1
- eventsBatchEventV1[]
  Description
  The events to record. Up to 1,000,000 events (150 MiB) per batch.
  - typestring<helpline_display | helpline_click>required
    Example
    helpline_display
    Description
    The kind of event being recorded.
    Allowed
    helpline_displayhelpline_click
  - helpline_idstring
    Example
    crisis-text-line
    Description
    Id of the helpline. Required, except on a display event that records that no helpline was shown.
  - session_idstringrequired
    Example
    3f0c8a2e-1d4b-4c9a-9e2f-7a1b2c3d4e5f
    Description
    Client-generated session identifier.
  - timestampstring<date-time>required
    Example
    2026-07-05T12:34:56Z
    Description
    ISO 8601 timestamp of when the event occurred.
    Format
    date-time
  - contact_methodstring<phone | sms | online_chat | website | tty | whatsapp | reporting_form>
    Example
    phone
    Description
    How the user reached the helpline. Required for click events; not used for display events.
    Allowed
    phonesmsonline_chatwebsitettywhatsappreporting_form
  - no_displayboolean
    Description
    For display events only: record that the API was queried but no helpline was shown. Mutually exclusive with the helpline id.

Submit a batch of helpline events (helplineDisplay and/or helplineClick). Returns 202 immediately with a jobId; poll the returned statusUrl for the per-item result. Duplicate detection is out of scope; retrying a batch resubmits the same events.