A Gift is the core transactional object in the Snappy system. It represents the entire gifting experience for a Recipient within a Campaign, from initial creation to final delivery.
The Gift object tracks the status and details through each stage of its lifecycle:
- Creation: The gift is initiated and associated with a recipient and campaign.
- Notification: The recipient is notified about their gift via email or other channels.
- Selection: The recipient selects a specific product from the gift collection (if applicable).
- Order Generation: An order is created based on the selected product and the recipient's shipping address.
- Delivery: The physical product is shipped and its delivery status is tracked to completion.
Use this endpoint to create a Gift and initiate the standard, multi-step gifting experience. This is the ideal flow when you want the recipient to have the flexibility to choose their own product and provide their own shipping address.
This call will generate a new Gift and send a notification to the recipient based on the details provided. To create a gift, you will need to provide:
- The
campaign_idof an existing campaign from which the gift will be sent. - A list of recipients to send the gifts to.
- Any optional overrides for the campaign's default settings (e.g., budget, collection). These overrides apply only to the gifts created in this specific call.
A successful request creates the Gift record and returns the object with an initial status (e.g., 'PENDING_SELECTION'), indicating it is waiting for the recipient's interaction.