Need Help?

Unlocked Features

  • Contact segmentation: Enables targeted communication by categorizing contacts based on specific criteria.

Supported Endpoints

EndpointeventVersionorigin
/v5/events (Events API)v2api

We recommend to send this event via JavaScript API

Example event

Below is an example event provided for testing. You can send this through the available endpoints to evaluate automation, segmentation, or any other custom functionalities.

Events API:


POST /v5/events
Host: api.omnisend.com
Content-Type: application/json

{
  "eventName": "ordered product",
  "origin": "api",
  "eventID": "f3f61bc6-07b8-4645-92d8-189d882dbcb1",
  "eventVersion": "v2",
  "eventTime": "2021-07-01T00:00:00Z",
  "contact": {
    "email": "[email protected]"
  },
  "properties": {
    "orderID": "4122111",
    "product": {
      "productCategories": [
        {
          "id": "123",
          "title": "Shoes"
        }
      ],
      "productDescription": "The best product with many various features",
      "productDiscount": 10.19,
      "productID": "1",
      "productImageURL": "https://example.com/product/232423-image.jpg",
      "productPrice": 19.99,
      "productQuantity": 2,
      "productSKU": 200,
      "productTags": [
        "tag1",
        "tag2"
      ],
      "productTitle": "The best product",
      "productURL": "https://example.com/product/232423",
      "productVariantID": "123",
      "productVariantImageURL": "https://example.com/product/232423-variant-image.jpg",
      "productVariantTitle": "Full product title - Green",
      "productVendor": "BestCompany",
      "productWeight": 20.4
    }
  }
}

Property explanation & expected types

Value PathDescriptionExampleType
orderIDOrder ID4122111string
productProduct-object
product.productCategoriesProduct Categories-array of objects
product.productCategories.idId123string
product.productCategories.titleTitleShoesstring
product.productDescriptionProduct DescriptionThe best product with many various featuresstring
product.productDiscountAbsolute value of product discount. I.e if current price is 20 and old price is 30, then discount should be 10.10.19number
product.productIDProduct ID1string
product.productImageURLDirect link to product imagehttps://example.com/product/232423-image.jpgstring
product.productPriceCurrent product price19.99number
product.productQuantityTotal added quantity2number
product.productSKUCurrent stock units200string
product.productStrikeThroughPrice!! This field was removed !!-number
product.productTagsProduct Tagstag1,tag2array of strings
product.productTitleFull product titleThe best productstring
product.productURLURL to product pagehttps://example.com/product/232423string
product.productVariantIDProduct Variant ID123string
product.productVariantImageURLDirect link to a product variant imagehttps://example.com/product/232423-variant-image.jpgstring
product.productVariantTitleProduct Variant TitleFull product title - Greenstring
product.productVendorProduct VendorBestCompanystring
product.productWeightProduct Weight20.4number