API Usage

Wunderkind triggers a Podium Orchestration by writing a Custom Event to a contact through Cordial's Asynchronous API POST /createContactactivities endpoint.

Wunderkind identifies the contact using channels.email.address, the sole entry in identifiersPriority. If no contact exists for that email, Cordial creates one (canBeCreated: true) with the wk_identified attribute set to true. If a contact already exists, it is not updated (canBeUpdated: false) and wk_identified is left blank.
Each object in the contactActivities array fires one Custom Event named for the triggering campaign strategy (for example, wknd-email-cartabandonment) — this is what enters the contact into the matching Podium Orchestration. The event’s properties object carries the JSON personalization payload. See the section below for the full set of event names and properties.
Requests are authenticated with an x-api-key header, using the Cordial API key connected in your Wunderkind Platform account's Integration Hub. See our Help Center for instructions and required API permissions for your AMP integration.

Sample API Request

The example below identifies a contact by email and fires the Product Abandonment Custom Event with a full properties payload.

{
  "source": "wk-esp",
  "contact": {
    "identifiers": {
      "email": "[email protected]"
    },
    "identifiersPriority": [
      "email"
    ],
    "attributes": {
      "channels.email.address": "[email protected]",
      "wk_identified": true
    },
    "canBeCreated": true,
    "canBeUpdated": false
  },
  "contactActivities": [
    {
      "name": "wknd-email-prodabandonment",
      "time": "2026-08-10T15:00:00+00:00",
      "properties": {
        "Origin": "wunderkind",
        "DataOnly": "Y",
        "UserType": "prospect",
        "WkOpen": "some-url.gif",
        "WkPurpose": "product abandonment",
        "WkChannel": "email",
        "WkCouponCode": "",
        "WkCouponPurpose": "",
        "Items": [
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "some-url.jpg",
            "WkUrl": "some-url.com"
          },
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "some-url.jpg",
            "WkUrl": "some-url.com"
          },
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "some-url.jpg",
            "WkUrl": "some-url.com"
          },
          {
            "WkCopy": "Product name",
            "WkId": "012345",
            "WkImageUrl": "some-url.jpg",
            "WkUrl": "some-url.com"
          }
        ]
      }
    }
  ]
}

If enabled for the account, "forceSubscribe": true is added to the contact object. This creates newly identified (wk_identified) contacts as already subscribed on the email channel, allowing them to receive promotional messages. Discuss this customization with your Wunderkind Customer Success Manager.

Account Pods

The request path is pod-specific. The pod is selected when connecting your Cordial account to Wunderkind Platform:

Pod	Endpoint
US West 1 (default)	`https://integrations-ingest-svc.cordial.com/api`
US West 2	`https://integrations-ingest-svc.usw2.cordial.com/api`
US East 1	`https://integrations-ingest-svc.use1.cordial.com/api`
Dedicated pod	`https://integrations-ingest-svc.{pod}.cordial.com/api`

Contact Activity Properties by Campaign Strategy

The properties object below is what Wunderkind sends for each default campaign strategy, keyed to its Custom Event name. Note that item counts vary by strategy. Product Abandonment and Category Recap include four items by default via product recommendations. Cart Abandonment, Back in Stock, Price Drop, and Low Stock do not include product recommendations by default and are not guaranteed to populate more than one item.

Cart Abandonment

Custom Event: wknd-email-cartabandonment

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "cart abandonment",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "WkCartReplenUrl": "some-url.com",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    }
  ]
}

Product Abandonment

Custom Event: wknd-email-prodabandonment

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "product abandonment",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    }
  ]
}

Category Recap

Custom Event: wknd-email-categoryrecap

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "category recap",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "WkCategoryUrl": "some-category-url.com",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    }
  ]
}

Back in Stock

Custom Event: wknd-email-backinstock

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "back in stock",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com"
    }
  ]
}

Price Drop

Custom Event: wknd-email-pricedrop

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "price drop",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkPrice": "49.99",
      "WkSalePrice": "39.99"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkPrice": "49.99",
      "WkSalePrice": "39.99"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkPrice": "49.99",
      "WkSalePrice": "39.99"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkPrice": "49.99",
      "WkSalePrice": "39.99"
    }
  ]
}

Low Stock

Custom Event: wknd-email-lowstock

{
  "Origin": "wunderkind",
  "DataOnly": "Y",
  "UserType": "prospect",
  "WkOpen": "some-url.gif",
  "WkPurpose": "low stock",
  "WkChannel": "email",
  "WkCouponCode": "",
  "WkCouponPurpose": "",
  "Items": [
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkQuantity": "1"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkQuantity": "1"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkQuantity": "1"
    },
    {
      "WkCopy": "Product name",
      "WkId": "012345",
      "WkImageUrl": "some-url.jpg",
      "WkUrl": "some-url.com",
      "WkQuantity": "1"
    }
  ]
}