The free gift promotion object
A comprehensive list of the free gift promotion resource's attributes and relationships
A free gift promotion object is returned as part of the response body of each successful list, retrieve, create or update API call to the
/api/free_gift_promotions
endpoint.Field | Type | Description |
---|---|---|
type | string | free_gift_promotions |
id | string | The free gift promotion unique identifier |
links.self | string | The free gift promotion endpoint URL |
attributes.name | string | The promotion's internal name. |
attributes.currency_code | string | The international 3-letter currency code as defined by the ISO 4217 standard. |
attributes.exclusive | boolean | Indicates if the promotion will be applied exclusively, based on its priority score. |
attributes.priority | integer | The priority assigned to the promotion (lower means higher priority). |
attributes.starts_at | datetime | The activation date/time of this promotion. |
attributes.expires_at | datetime | The expiration date/time of this promotion (must be after starts_at). |
attributes.total_usage_limit | integer | The total number of times this promotion can be applied. |
attributes.total_usage_count | integer | The number of times this promotion has been applied. |
attributes.active | boolean | Indicates if the promotion is active (enabled and not expired). |
attributes._disable | boolean | Send this attribute if you want to mark the promotion as disabled. |
attributes._enable | boolean | Send this attribute if you want to mark the promotion as enabled. |
attributes.disabled_at | datetime | Time at which the promotion was disabled. |
attributes.created_at | datetime | Time at which the resource was created. |
attributes.updated_at | datetime | Time at which the resource was last updated. |
attributes.reference | string | A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever. |
attributes.reference_origin | string | Any identifier of the third party system that defines the reference code |
attributes.metadata | object | Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format. |
attributes.max_quantity | integer | The max quantity of free gifts globally applicable by the promotion. |
relationships.market | object | The associated market. |
relationships.promotion_rules | array | The associated promotion rules. |
relationships.order_amount_promotion_rule | object | The associated order amount promotion rule. |
relationships.sku_list_promotion_rule | object | The associated SKU list promotion rule. |
relationships.coupon_codes_promotion_rule | object | The associated coupon codes promotion rule. |
relationships.coupons | array | The associated coupons through coupon codes promotion rule. |
relationships.sku_list | object | The associated SKU list. |
relationships.attachments | array | The associated attachments. |
relationships.events | array | The associated events. |
relationships.tags | array | The associated tags. |
relationships.versions | array | The associated changes. |
relationships.skus | array | The associated SKUs. |
meta.mode | string | The resource environment (can be one of test or live ) |
Last modified 1d ago