Events API Documentation

Create Recipient Event

Use the API to create a recipient event for tracking customer interactions and behaviors.

[POST]
https://api-us1.stannp.com/v1/recipientEvents/create

Parameters

ParameterTypeDescription
recipient_idstringAn id of the recipient. This needs to be the recipient_id or the alternative reference id which can be used to match an id from a different system.
namestringName the event. For example: PURCHASE, SIGNUP, PAGE_VIEW, PRODUCT_VIEW, PRODUCT_TO_BASKET.
valuestringAdd value information. For example, the value of the purchase or the product name.
conversionboolTrue or false. Is this a conversion event (e.g., purchasing or a signup)? Defaults to false.
datastringAny extended data you wish to store about this event for automation tasks or dynamic templating.
refstringCan be a campaign reference id or a mailpiece reference id. If left empty, we will use any recent communication to allocate as a reference.

Request Example

        curl "https://api-us1.stannp.com/v1/recipientEvents/create" \
-u {API_KEY}: \

    

Response Example

{
  "success": true,
  "data": 266
}