Creates a new event, sending event data in the request body.
Two objects are required: general_data and either transaction_data or action_data. general_data requires the fields: event_id, event_type, and event_time. transaction_data requires only the field amount.
Unlike entities, events on our system are cannot be explicitly updated. However, they can be overwritten in a naive upsert-overwrite fashion. If we receive a request to create an event for an event_id that already exists in our system, we will simply overwrite that previous entry with the newly provided data if this transaction is not already associated with other articles in our system.
For instance, if a transaction is flagged in an alert and we receive a request to overwrite the details of this transaction, we will respond with a 409 error code indicating that this event cannot be overwritten.
The response will consist of the following fields:
Unique identifier of the event on your platform
Internal ID of the entity within Unit21's system
If entity (with the same event_id) already exists
Updates to an event's general_data.event_id are not allowed.
You can also batch upload entities to events/create.
Click Try It! to start a request and see the response here!