Holder assignment created

post https://example.com/EVENTS.CUSTOMER.HOLDER.ASSIGNMENT.CREATED

EVENT: "EVENTS.CUSTOMER.HOLDER.ASSIGNMENT.CREATED"
HTTP method: POST

The EVENTS.CUSTOMER.HOLDER.ASSIGNMENT.CREATED event indicates that a customer has been assigned to a redeemable.

This event is used in a webhook configured in Project settings in Voucherify dashboard.

This event can be viewed in Voucherify logs or as part of events listed under the List Customer Activity endpoint.

Example: customer.holder.assignment.created

{
  "holder": {
    "id": "rh_0f147785a5c966e4b3",
    "object": "redeemable_holder",
    "created_at": "2024-07-19T12:19:07.002Z",
    "campaign_id": "camp_vVk4unz3k4gA023fk9XoSiTh",
    "customer_id": "cust_3yngSdlObyvUtdDcnHiGu6Yx",
    "holder_role": "REFEREE",
    "voucher_type": "DISCOUNT_VOUCHER",
    "campaign_type": "REFERRAL_PROGRAM",
    "redeemable_id": "v_uOrG9tQresN9X51gbAoo0a2vY4MLV9lS",
    "publication_id": null,
    "redeemable_object": "voucher"
  },
  "voucher": {
    "id": "v_uOrG9tQresN9X51gbAoo0a2vY4MLV9lS",
    "code": "REFAPI-mk3",
    "type": "DISCOUNT_VOUCHER",
    "active": true,
    "object": "voucher",
    "campaign": "Referral API",
    "discount": {
      "type": "AMOUNT",
      "effect": "APPLY_TO_ORDER",
      "amount_off": 900
    },
    "metadata": {},
    "holder_id": "cust_33924S073JcRVZJRfychtHhW",
    "created_at": "2024-04-02T13:58:14.081Z",
    "redemption": {
      "quantity": null,
      "redeemed_quantity": 0
    },
    "start_date": null,
    "updated_at": "2024-04-02T13:58:25.511Z",
    "campaign_id": "camp_vVk4unz3k4gA023fk9XoSiTh",
    "category_id": "cat_0d7c4d183011d043cc",
    "referrer_id": "cust_33924S073JcRVZJRfychtHhW",
    "expiration_date": null,
    "is_referral_code": true
  },
  "campaign": {
    "id": "camp_vVk4unz3k4gA023fk9XoSiTh",
    "name": "Referral API",
    "type": "AUTO_UPDATE",
    "active": true,
    "object": "campaign",
    "voucher": {
      "gift": null,
      "type": "DISCOUNT_VOUCHER",
      "discount": {
        "type": "AMOUNT",
        "units": null,
        "effect": "APPLY_TO_ORDER",
        "amount_off": 900
      },
      "redemption": {
        "quantity": null,
        "redeemed_quantity": 0
      },
      "code_config": {
        "length": 3,
        "prefix": "REFAPI-",
        "charset": "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "pattern": "###",
        "postfix": ""
      },
      "loyalty_card": null
    },
    "category": null,
    "metadata": {},
    "auto_join": false,
    "join_once": false,
    "created_at": "2024-04-02T13:58:13.738Z",
    "start_date": null,
    "category_id": "cat_0d7c4d183011d043cc",
    "description": null,
    "campaign_type": "REFERRAL_PROGRAM",
    "expiration_date": null,
    "is_referral_code": true,
    "referral_program": {
      "conversion_event_type": "redemption"
    }
  },
  "customer": {
    "id": "cust_3yngSdlObyvUtdDcnHiGu6Yx",
    "name": null,
    "email": null,
    "object": "customer",
    "metadata": {},
    "source_id": null
  }
}

Response

Response body

object

holder

object

required

Details about the holder of the redeemable.

string

required

Unique identifier of the redeemable holder.

created_at

date-time

required

Timestamp representing the date and time when the redeemable was assigned. Timestamp is presented in the ISO 8601 format.

redeemable_id

string

required

Identifier of the redeemable item.

redeemable_object

string

required

Type of the redeemable.

voucher

campaign_id

string

required

Unique identifier of the campaign as assigned by Voucherify.

campaign_type

string

required

Defines the type of the campaign.

REFERRAL_PROGRAM

voucher_type

string

required

Defines the type of the voucher.

GIFT_VOUCHER DISCOUNT_VOUCHER LOYALTY_CARD

publication_id

string | null

required

Unique identifier of the publication.

customer_id

string

required

Unique identifier of the customer.

holder_role

string

required

Role of the holder.

OWNER REFERRER REFEREE

object

string

required

The type of the object represented by JSON.

redeemable_holder

voucher

object

required

Simplified voucher data.

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

campaign

object

required

Simplified campaign data.

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

customer

object

required

Simplified customer data.

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.CUSTOMER.HOLDER.ASSIGNMENT.CREATED"HTTP method: POST

Example: customer.holder.assignment.created

200Indicates that a customer has been assigned a redeemable.

EVENT: "EVENTS.CUSTOMER.HOLDER.ASSIGNMENT.CREATED"
HTTP method: POST