HomeGuidesAPI Reference
Need Help?
API Reference
Need Help?

Send Customer event

post
https://api.omnisend.com/api/events

With this endpoint you can send customer events to Omnisend. Customer events are used to track customer behavior and trigger automations based on that behavior. You can either format and send custom customer events or use predefined events.

Scopes: events.write
Open Postman collection

Body Params

event information

contact
object

Contact information, contact will be created or updated based on the data provided here.

string

UUID of the event (v4, v5, v6, v7). Along with 'eventTime' used for historical event deduplication (not working on real-time events used for automations). If not provided, it will be generated automatically.

string

Check event documentation to find what event names you need to specify for each event.

string

RFC3339 format if not provided, current time will be used.

string

Required ONLY for recommended events. Check event documentation to find what version you need to specify for each event. For custom events you should leave it empty.

string

It should be based on the source of event API. If you are building platform or app integration it should have dedicated origin. Otherwise it should be "api".

properties
object

Event properties, you can check events guides section to see what recommended properties you should provide for each event. Not providing recommending properties can result some of the features not working properly.

Headers
string
required
Defaults to 2026-03-15

API version that specifies the response format and behaviour

Responses
202

Accepted

Updated 27 days ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 27 days ago