Order Created

WEBHOOK EVENTS.CUSTOMER.ORDER.CREATED

customer.order.created

{
  "customer": {
    "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "name": "Jack Webhook",
    "email": null,
    "source_id": "jck-wbhk",
    "metadata": {
      "region": "EMEA",
      "sign-up": "true"
    },
    "object": "customer"
  },
  "referrer": null,
  "order": {
    "id": "ord_jM5GdBe4OO3ExFrVSlEWLORP",
    "source_id": null,
    "created_at": "2024-03-12T14:41:49.128Z",
    "updated_at": null,
    "status": "CREATED",
    "amount": 2500,
    "total_amount": 2500,
    "items": [
      {
        "object": "order_item",
        "product_id": "prod_0df14b7e7d8975079d",
        "quantity": 1,
        "amount": 2500,
        "price": 2500,
        "subtotal_amount": 2500,
        "product": {
          "name": "Star Thermal Bottle",
          "price": 2500
        }
      },
      {
        "object": "order_item",
        "product_id": "prod_5h1pp1ng",
        "quantity": 1,
        "amount": 0,
        "price": 0,
        "subtotal_amount": 0,
        "product": {
          "name": "Shipping"
        }
      }
    ],
    "metadata": {
      "card": [
        "Other"
      ],
      "region": "US",
      "currency": "USD"
    },
    "customer": {
      "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
      "address": null,
      "summary": null,
      "loyalty": null,
      "referrals": null,
      "object": "customer"
    },
    "customer_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "referrer_id": null,
    "object": "order"
  },
  "redemption": null
}

The EVENTS.CUSTOMER.ORDER.CREATED event indicates that a customer-related order has been created.

When the event is used in an “Order creation” distribution webhook, the data object always contains the following required objects:

• customer,
• referrer,
• order,
• redemption.

Additional objects are also sent depending on the purpose:

• “Notify customers about promotion” sends also the following objects:
  • campaign,
  • promotion_tier,
• “Send and publish unique codes from campaign” sends also the following objects:
  • campaign,
  • voucher,
  • publication,
• “Send plain message to customers” sends only the basic objects listed above.

This event is used in a webhook configured in Distributions in Voucherify dashboard.

This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Introduction to webhooks page.

Body

application/json

Event data object schema for customer.order.created.

customer · Simple Customer · object · required

Simplified customer data.

Show child attributes

referrer · Simple Customer · object · required

Simplified customer data.

Show child attributes

order · Order Calculated · object · required

Order information.

Show child attributes

redemption · Redemption Internal · object · required

Redemption data used for internal communication

Show child attributes

campaign · Simple Campaign · object

Details about the campaign related to the distribution with a promotion or send voucher purpose.

Show child attributes

voucher · Simple Voucher · object

Details about the voucher related to the distribution with a send voucher purpose.

Show child attributes

publication · Publications Item Base · object

Details about the publication related to the distribution with a send voucher purpose.

Show child attributes

promotion_tier · Simple Promotion Tier · object

Details about the promotion tier related to the distribution with a promotion purpose.

Show child attributes

Response

200

Webhook accepted