INinfobip
customer-engagement
people
events

Batch Send Events

Use this endpoint to batch import People events, including historical events that occurred up to 30 days ago. Batch items must reference an existing person profile and predefined event type. You can send up to 5000 events in a single batch. Each individual item within a batch must not exceed 512,000 bytes. The entire batch, which includes all items combined, must not exceed 15,728,640 bytes.<br>Each event in the batch must reference an existing person profile and a predefined event type. If an event references a person identifier that does not match any existing profile, a new CUSTOMER profile will automatically be created for that identifier. <br>Note: The entire batch will fail to import if any single event fails due to missing event type, properties, etc.

post/people/3/events

Request

  • Base URL
    https://api.infobip.com (the document declares no server; this is the origin it was published from)
  • Auth
    • HTTP basic
    • or API key in header Authorization
    • or API key in header Authorization
    • or OAuth 2
      Client credentials
      Token URL: https://api.infobip.com/auth/1/oauth2/token

Request body

eventIdstring nullable

Unique identifier of the event. If provided, it helps prevent duplicate events in case of retries—for example, if the first API call fails and the same event is sent again. Passing the same eventId ensures the event is only recorded once in the person profile.<br>The value must be 1–36 characters long and can include letters (A–Z, a–z), digits (0–9), underscores (_), and hyphens (-) only.

definitionIdstring required

Unique identifier of event schema.

occurredTimestring date-time required

Time of event occurrence, as the following format yyyy-MM-dd'T'HH:mm:ss.SSSZ. Events occurred more than 30 days ago will be rejected. Future dates are not allowed and will be automatically set to the current UTC time.

propertiesobject nullable

Object containing event properties. Must match the corresponding event definition. See People Events documentation for supported data types.

Example request

[
  {
    "occurredTime": "2025-03-17T13:00:27.864Z"
  }
]

Response

Accepted

Changes

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