Manual_distribution_schedule

post https://example.com/EVENTS.DISTRIBUTION.MANUAL_DISTRIBUTION_SCHEDULE

EVENT: "EVENTS.DISTRIBUTION.MANUAL_DISTRIBUTION_SCHEDULE"
HTTP method: POST

The MANUAL_DISTRIBUTION_SCHEDULE event indicates that the distribution is a result of a scheduled distribution.

When the event is used in a "Manual message" distribution webhook, the data object always contains the following required objects:

distribution.

Additional objects are also sent depending on the purpose:

"Notify customers about promotion" sends also the following objects:
- campaign,
- customer,
- promotion_tier,
"Send and publish unique codes from campaign" sends also the following objects:
- campaign,
- voucher,
- customer,
- publication,
"Send plain message to customers" is unavailable for this distribution webhook.

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

📘
Webhook documentation
This page documents only the event. If you need more details about the webhook payload data that includes this event, go to Webhook v2024-01-01 page.

Example: manual distribution schedule

{
  "distribution": {
    "id": "distr_3oun3MaJpcqzxYmHN0PReck1k8",
    "created_at": "2024-03-13T13:37:39.250Z",
    "updated_at": null,
    "status": "TO SEND",
    "consents": {
      "disabled": true
    },
    "set_live_at": null,
    "distribution_channels": [
      "webhook"
    ]
  },
  "campaign": {
    "id": "camp_iRMdcq07g9W4dOSRXuTovupi",
    "name": "Spring Discounts",
    "campaign_type": "DISCOUNT_COUPONS",
    "type": "AUTO_UPDATE",
    "is_referral_code": false,
    "voucher": {
      "type": "DISCOUNT_VOUCHER",
      "discount": {
        "type": "PERCENT",
        "amount_limit": 3000,
        "percent_off": 10,
        "percent_off_formula": "IF(ORDER_AMOUNT > 150;15;10)",
        "units": null,
        "effect": "APPLY_TO_ORDER"
      },
      "gift": null,
      "loyalty_card": null,
      "redemption": {
        "quantity": 1,
        "redeemed_quantity": 0
      },
      "code_config": {
        "pattern": "###",
        "length": 3,
        "charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "prefix": "SPRING-2024-",
        "postfix": ""
      }
    },
    "auto_join": false,
    "join_once": false,
    "active": true,
    "category_id": "cat_0e156dab8f2e43873a",
    "category": null,
    "metadata": {},
    "start_date": null,
    "expiration_date": null,
    "description": "Spring 2024 big campaign",
    "created_at": "2024-02-21T10:01:24.102Z",
    "updated_at": "2024-02-23T11:43:11.539Z",
    "object": "campaign"
  },
  "voucher": {
    "id": "v_ae1exRSLU9I4ncJjY5heHvVTE189Y3NB",
    "code": "SPRING-2024-osO",
    "discount": {
      "type": "PERCENT",
      "amount_limit": 3000,
      "percent_off": 10,
      "effect": "APPLY_TO_ORDER",
      "percent_off_formula": "IF(ORDER_AMOUNT > 150;15;10)"
    },
    "type": "DISCOUNT_VOUCHER",
    "campaign": "Spring Discounts",
    "campaign_id": "camp_iRMdcq07g9W4dOSRXuTovupi",
    "is_referral_code": false,
    "holder_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "category_id": "cat_0e156dab8f2e43873a",
    "active": true,
    "created_at": "2024-03-13T13:45:41.161Z",
    "updated_at": "2024-03-13T13:46:48.140Z",
    "redemption": {
      "quantity": 1,
      "redeemed_quantity": 0
    },
    "start_date": null,
    "expiration_date": null,
    "metadata": {},
    "object": "voucher"
  },
  "customer": {
    "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "name": "Jack Webhook",
    "email": null,
    "source_id": "jck-wbhk",
    "metadata": {
      "region": "EMEA",
      "sign-up": "true"
    },
    "object": "customer"
  },
  "publication": {
    "id": "pub_eB4okLT7vHrFoajHJGeoKir285dBxY1z",
    "object": "publication",
    "created_at": "2024-03-13T13:46:48.136Z",
    "customer_id": "cust_IdgAFZxYwwHctOk9pPuMu308",
    "tracking_id": "jck-wbhk",
    "metadata": {
      "source_type": "distribution",
      "source_id": "distr_3oun3MaJpcqzxYmHN0PReck1k8",
      "distribution_id": "distr_3oun3MaJpcqzxYmHN0PReck1k8"
    },
    "channel": "Dashboard",
    "source_id": null,
    "result": "SUCCESS",
    "customer": {
      "id": "cust_IdgAFZxYwwHctOk9pPuMu308",
      "source_id": "jck-wbhk",
      "name": "Jack Webhook",
      "address": null,
      "summary": null,
      "loyalty": null,
      "referrals": null,
      "metadata": {
        "region": "EMEA",
        "sign-up": "true"
      },
      "object": "customer"
    },
    "vouchers_id": [
      "v_ae1exRSLU9I4ncJjY5heHvVTE189Y3NB"
    ]
  }
}

Response

Response body

object

distribution

object

required

Simple distribution data.

string

Unique identifier of the distribution.

created_at

date-time

Timestamp representing the date and time when the object was created in the ISO 8601 format.

updated_at

date-time | null

Timestamp representing the date and time when the object was last updated in the ISO 8601 format.

status

string

Indicates the status of the distribution.

TO SEND PAUSED DONE DRAFT

parameters

object

Defines the parameters of the distribution

consents

object

Determines the details about the consents

set_live_at

date-time | null

Determines the date and time when the distribution will go live.

distribution_channels

array

Defines the channels of the distribution.

activecampaign batch braze email intercom klaviyo mailchimp shopify sms webhook

distribution_channels

campaign

object

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

string

Campaign ID.

name

string

Campaign name.

campaign_type

string

Type of campaign.

type

string

Defines whether the campaign can be updated with new vouchers after campaign creation or if the campaign consists of standalone vouchers.

AUTO_UPDATE: the campaign is dynamic, i.e. vouchers will generate based on set criteria
STATIC: vouchers need to be manually published
STANDALONE: campaign for single vouchers

AUTO_UPDATE STATIC STANDALONE

is_referral_code

boolean

Flag indicating whether this voucher is a referral code; true for campaign type REFERRAL_PROGRAM.

voucher

object

Simplified campaign voucher data.

referral_program

object

Defines the referee reward and the way a referral is triggered. Context: REFERRAL_PROGRAM.

auto_join

boolean

Indicates whether customers will be able to auto-join the campaign if any earning rule is fulfilled.

join_once

boolean

If this value is set to true, customers will be able to join the campaign only once. It is always false for standalone voucher campaigns and it cannot be changed in them.

active

boolean

Indicates whether the campaign is active.

category_id

string | null

The unique category ID that this campaign belongs to.

categories

array of objects

Contains details about the category.

categories

object

string

required

Unique category ID assigned by Voucherify.

name

string

required

Category name.

hierarchy

integer

required

Category hierarchy.

created_at

date-time

required

Timestamp representing the date and time when the category was created in the ISO 8601 format.

updated_at

date-time

Timestamp representing the date and time when the category was updated in the ISO 8601 format.

object

string

required

Defaults to category

The type of the object represented by the JSON. This object stores information about the category.

category

stacking_rules_type

string

The type of the stacking rule eligibility.

JOINT EXCLUSIVE

metadata

object

A set of custom key/value pairs that you can attach to a campaign. The metadata object stores all custom attributes assigned to the campaign.

Has additional fields

start_date

date-time

Activation timestamp defines when the campaign starts to be active in ISO 8601 format. Campaign is inactive before this date.

expiration_date

date-time

Expiration timestamp defines when the campaign expires in ISO 8601 format. Campaign is inactive after this date.

description

string

An optional field to keep extra textual information about the campaign such as a campaign description and details.

created_at

date-time

Timestamp representing the date and time when the campaign was created. The value is shown in the ISO 8601 format.

updated_at

date-time

Timestamp representing the date and time when the campaign was updated in the ISO 8601 format.

object

string

Defaults to campaign

The type of the object represented by JSON. This object stores information about the campaign.

campaign

voucher

object

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

string

A unique identifier that represents the voucher assigned by Voucherify.

code

string

required

Voucher code.

gift

object

Contains current gift card balance information.

discount

object

Contains information about discount.

loyalty_card

object

Simplified loyalty card data.

type

string

required

Type of the voucher.

DISCOUNT_VOUCHER LOYALTY_CARD GIFT_VOUCHER

campaign

string

Campaign name.

campaign_id

string

Campaign unique ID.

is_referral_code

boolean

Flag indicating whether this voucher is a referral code; true for campaign type REFERRAL_PROGRAM.

holder_id

string

Unique customer identifier of the redeemable holder. It equals to the customer ID assigned by Voucherify.

referrer_id

string

Unique identifier of the referrer assigned by Voucherify.

category_id

string | null

Unique identifier of the category that this voucher belongs to.

categories

array of objects

Contains details about the category.

categories

object

string

required

Unique category ID assigned by Voucherify.

name

string

required

Category name.

hierarchy

integer

required

Category hierarchy.

created_at

date-time

required

Timestamp representing the date and time when the category was created in the ISO 8601 format.

updated_at

date-time

Timestamp representing the date and time when the category was updated in the ISO 8601 format.

object

string

required

Defaults to category

The type of the object represented by the JSON. This object stores information about the category.

category

stacking_rules_type

string

The type of the stacking rule eligibility.

JOINT EXCLUSIVE

active

boolean

Shows whether the voucher is on or off. true indicates an active voucher and false indicates an inactive voucher.

created_at

date-time

required

Timestamp representing the date and time when the order was created in the ISO 8601 format.

updated_at

date-time

Timestamp representing the date and time when the order was created. The value is shown in the ISO 8601 format.

redemption

object

Defines the redemption limits on vouchers.

start_date

date-time

Activation timestamp defines when the code starts to be active in ISO 8601 format. Voucher is inactive before this date.

expiration_date

date-time

Expiration timestamp defines when the code expires in ISO 8601 format. Voucher is inactive after this date.

metadata

object

A set of custom key/value pairs that you can attach to a voucher. The metadata object stores all custom attributes assigned to the voucher.

Has additional fields

object

string

required

Defaults to voucher

The type of the object represented by JSON.

voucher

publication

object

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

string

required

Unique identifier of the publication assigned by Voucherify.

object

string

required

Defaults to publication

The type of the object represented by the JSON. This object stores information about the publication.

publication

created_at

date-time

required

Timestamp representing the date and time when the publication was created in the ISO 8601 format.

customer_id

string

required

Unique identifier of the customer receiving the publication.

tracking_id

string

Customer's source_id.

metadata

object

required

The metadata object stores all custom attributes assigned to the publication.

channel

string

required

How the publication was originated.

source_id

string | null

required

Unique identifier of the merchant's publication if it is different from the Voucherify publication ID.

result

string

Defaults to SUCCESS

Status of the publication attempt.

SUCCESS

customer

object

required

Customer details with details about loyalty and referral programs.

vouchers_id

array of strings

required

Contains the unique internal voucher ID that was assigned by Voucherify.

vouchers_id*

promotion_tier

object

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

string

Unique promotion tier ID.

name

string

Name of the promotion tier.

banner

string | null

Text to be displayed to your customers on your website.

campaign

object

Simplified promotion tier campaign data.

metadata

object

A set of custom key/value pairs that you can attach to a promotion tier. The metadata object stores all custom attributes assigned to the promotion tier.

Has additional fields

customer

object

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

string

Unique identifier of an existing customer. It is assigned by Voucherify.

name

string

Customer's first and last name.

string

Customer's email address.

source_id

string

A unique identifier of the customer. It can be a customer ID or email from a CRM system, database, or a third-party service.

metadata

object

A set of custom key/value pairs that are attached to the customer. It stores all custom attributes assigned to the customer.

Has additional fields

object

string

The type of the object represented by JSON.

customer

EVENT: "EVENTS.DISTRIBUTION.MANUAL_DISTRIBUTION_SCHEDULE"HTTP method: POST

📘Webhook documentation

Example: manual distribution schedule

200Indicates that a manual distribution has been scheduled.

EVENT: "EVENTS.DISTRIBUTION.MANUAL_DISTRIBUTION_SCHEDULE"
HTTP method: POST

📘
Webhook documentation