v1

latestOpenAPI 3.1.02026-07-246014.7 KB

Create Custom Event

Send a Custom Event to use in Flows

post/api/v2/events

Headers

X-Postscript-Shop-Tokenstring

Shop API Token. Required for partners. This header should be used only by partners. Shops should include their API token in the Authorization header.

Request body

typestring required

The type of event that you are creating. This is the name of the event that will show in the Postscript application. Note: when creating this event, we will automatically prefix your partner/shop name in front of the event. For example, if sending an event called "OrderPlaced", we'll show it in our UI as "[Your Partner/Shop Name] - OrderPlaced" to distinguish it from others of a similar name. We accept the follow characters in the value field: lowercase letters (a-z), uppercase letters (A-Z), digits (0-9), and underscores (_).

subscriber_idstring

The ID of the subscriber that you are creating the event for.

phonestring

The phone number of the subscriber that you are creating the event for. E.164 format is recommended, but other formats will be accepted.

emailstring

The email of the subscriber that you are creating the event for.

occurred_atstring date

When the event occurred. This parameter is optional but allows you to set the exact time that the event occurred on your system. If it is not sent to us, we will just use the current time when we receive it. The following UTC time format is supported: %Y-%m-%d %H:%M:%S.%f

external_idstring

The unique id of the event on your system. This is an optional field. If a value is not provided, we will create a default id ourselves based on time of event received.

Response

202

event_idsstring[]

Example response

{
  "event_ids": [
    "1234-abcd-5678"
  ]
}