> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gift Up!

> Gift Up! is a digital platform that allows businesses to sell, manage, and redeem gift cards online, integrating seamlessly with websites and apps to streamline gift card transactions and promotions.

![Gift Up! logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/gift_up.ico?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=f7566be2a648802ed5ce9d7d4974f70e)

* **Category:** ecommerce
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 44
* **Triggers:** 0
* **Slug:** `GIFT_UP`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Note to Order
>
> **Slug:** `GIFT_UP_ADD_ORDER_NOTE`
>
> Add a note of up to 500 characters to an existing order for internal tracking. The action then retrieves the order and returns its last note; the note may be added even if that follow-up retrieval fails.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique GUID identifier of the order to add a note to.
>
> **content** `string` *required*
>
> The note content to add to the order. Must be no more than 500 characters in length. Use notes to track additional information about an order.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Item
>
> **Slug:** `GIFT_UP_CREATE_ITEM`
>
> Tool to create a new item for sale in the Gift Up checkout. An item represents a product that can be purchased (gift cards, vouchers, passes, etc.). Use when you need to add new products to the Gift Up store, set up gift card offerings with specific prices and values, or configure items with custom pricing, expiry rules, and availability windows.
>
> #### Input Parameters
>
> **sku** `string`
>
> Private SKU or item code for integration with external inventory/POS systems. Not visible to customers
>
> **name** `string` *required*
>
> The name of the item to be displayed to customers
>
> **codes** `array`
>
> Pre-generated codes to be issued when this item is sold. Useful for integrating with third-party redemption systems
>
> **price** `string`
>
> Amount charged to the purchaser. Required for Specified pricing type. For Currency-backed items with Specified pricing, this is the price customers pay
>
> **units** `integer`
>
> Unit balance issued on the gift card. Required for Units-backed items. Represents quantity (e.g., 5 classes, 10 visits)
>
> **value** `string`
>
> Currency balance issued on the gift card. Required for Currency-backed items with Specified pricing. Can differ from price for discounts/premiums
>
> **groupId** `string`
>
> UUID of the item group to associate this item with. Groups help organize related items for management and reporting
>
> **priceType** `string ("Specified" | "Custom")` *required*
>
> Price model. 'Specified' for fixed-price items, 'Custom' to allow customers to enter their own price
>
> **detailsURL** `string`
>
> Fully qualified absolute URL linking to more information about the item. Must start with http\:// or https\://
>
> **stockLevel** `integer`
>
> Available inventory quantity. When stock reaches zero, item cannot be purchased. Leave unset for unlimited inventory
>
> **backingType** `string ("Currency" | "Units")` *required*
>
> Balance backing type. 'Currency' for monetary value (e.g., \$50 gift card), 'Units' for quantity-based items (e.g., 5 class passes)
>
> **description** `string`
>
> Detailed description of the item shown to customers during purchase
>
> **maximumPrice** `string`
>
> Maximum price customers can enter for Custom pricing type. Only applicable when priceType is Custom
>
> **minimumPrice** `string`
>
> Minimum price customers can enter for Custom pricing type. Only applicable when priceType is Custom
>
> **availableFrom** `string`
>
> ISO 8601 datetime string when customers can start purchasing this item. If not specified, item is immediately available
>
> **perOrderLimit** `integer`
>
> Maximum quantity customers can purchase in a single order. Leave unset for no per-order limit
>
> **availableUntil** `string`
>
> ISO 8601 datetime string when purchase availability ends. If not specified, item remains available indefinitely
>
> **overrideExpiry** `boolean`
>
> Set to true to use custom expiry settings for this item instead of account defaults. Use with expiresInMonths to specify item-specific expiration
>
> **additionalTerms** `string`
>
> Additional terms and conditions specific to this item, displayed to customers beyond account-level defaults
>
> **expiresInMonths** `integer`
>
> Number of months after purchase before gift cards from this item expire. If not specified, uses account default expiry settings
>
> **validFromInDays** `string`
>
> Number of days after purchase before gift cards become valid/redeemable. Useful for delayed activation (e.g., holiday gifts)
>
> **overrideValidFrom** `boolean`
>
> Set to true to use custom valid-from settings for this item instead of account defaults. Use with validFromInDays to specify when cards become active
>
> **equivalentValuePerUnit** `string`
>
> Value per unit for reporting purposes. Required for Units-backed items. Used to calculate total value for analytics (e.g., \$20 per class pass)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Item Group
>
> **Slug:** `GIFT_UP_CREATE_ITEM_GROUP`
>
> Tool to create a new item group for organizing items in the Gift Up checkout. Use when you need to create a container for grouping items together.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the item group
>
> **sortOrder** `integer`
>
> The sort order for how the groups appear in the checkout (ascending), default is 0
>
> **autoExpand** `boolean`
>
> Whether to expand the items by default in this group on the checkout, default is false
>
> **description** `string`
>
> The description of the item group
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Order
>
> **Slug:** `GIFT_UP_CREATE_ORDER`
>
> Tool to create a new order which generates one or more gift cards. Use when you need to programmatically create gift card orders through the Gift Up API. Orders encapsulate transaction data and contain gift card details including codes, balances, and fulfillment information.
>
> #### Input Parameters
>
> **tip** `string`
>
> Optional tip amount (must be positive if provided)
>
> **revenue** `string` *required*
>
> Total revenue amount for the order (must be positive)
>
> **discount** `string`
>
> Total discount amount applied to the order
>
> **metadata** `object`
>
> Key-value pairs for storing additional data (maximum 20 keys)
>
> **referrer** `string`
>
> Origin reference for the order (e.g., sales representative name or source)
>
> **orderDate** `string`
>
> When the order was created (UTC, ISO 8601); defaults to current time if not provided
>
> **salesTaxes** `array`
>
> Sales tax information for the order
>
> **serviceFee** `string`
>
> Optional service fee amount (must be positive if provided)
>
> **itemDetails** `array` *required*
>
> List of gift card items to create (at least one required)
>
> **customFields** `array`
>
> Custom field data to collect with the order
>
> **purchaserName** `string` *required*
>
> Full name of the purchaser
>
> **purchaserEmail** `string` *required*
>
> Email address of the purchaser
>
> **disableAllEmails** `boolean`
>
> Set to true to prevent Gift Up from sending any emails for this order; defaults to false
>
> **recipientDetails** `object`
>
> Recipient and fulfillment information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Item
>
> **Slug:** `GIFT_UP_DELETE_ITEM`
>
> Tool to delete an item from the Gift Up checkout. Removes the item from sale. Use when you need to permanently remove an item by its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique GUID identifier of the item to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Item Group
>
> **Slug:** `GIFT_UP_DELETE_ITEM_GROUP`
>
> Tool to delete an item group by its ID. Use when you need to remove an item group that has no items in it.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The GUID of the item group to delete. Will fail if items exist in the group.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `GIFT_UP_DELETE_WEBHOOK`
>
> Tool to delete a webhook subscription by its ID. Use when you need to remove an existing webhook subscription.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique GUID identifier of the webhook subscription to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Checkout Settings
>
> **Slug:** `GIFT_UP_GET_CHECKOUT_SETTINGS`
>
> Retrieve the current checkout settings for the Gift Up account. Use the result to display or audit the checkout configuration, including its appearance, fees, and tipping options.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Details
>
> **Slug:** `GIFT_UP_GET_COMPANY`
>
> Tool to retrieve company details. Use when you need to fetch the current company associated with the API key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Email Settings
>
> **Slug:** `GIFT_UP_GET_EMAIL_SETTINGS`
>
> Retrieve the Gift Up account's default email settings, including sender details and gift card and receipt email configuration. Use this to inspect the content and branding of customer emails.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Gift Card by Code
>
> **Slug:** `GIFT_UP_GET_GIFT_CARD`
>
> Retrieve a gift card by its code to view its balance, status, and transaction history. Use it to inspect a specific card and its redemption details.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Gift Card Settings
>
> **Slug:** `GIFT_UP_GET_GIFT_CARD_SETTINGS`
>
> Retrieve the Gift Up account's gift card settings, including code and barcode formats, expiration rules, and display options. Use this to inspect how gift cards are configured.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Item by ID
>
> **Slug:** `GIFT_UP_GET_ITEM`
>
> Tool to retrieve detailed information about a specific item by its ID. Use when you need to fetch complete details about an item including price, availability, stock levels, and configuration settings.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier (GUID) of the item to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order by ID
>
> **Slug:** `GIFT_UP_GET_ORDER`
>
> Retrieve an order by ID, including customer and payment details. Gift card details are returned only if included in the order response.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the order to retrieve (GUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] API Health Check
>
> **Slug:** `GIFT_UP_GET_PING`
>
> Tool to perform a health check on the Gift Up! API. Use when you need to verify API connectivity and authentication without fetching account-specific data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Report Transaction
>
> **Slug:** `GIFT_UP_GET_REPORT_TRANSACTION`
>
> Tool to retrieve a specific transaction report by its ID. Use when you need detailed transaction information for accounting purposes.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The id (GUID) of the transaction to retrieve
>
> **test\_mode** `boolean`
>
> If true, include header x-giftup-testmode: true to use test mode.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Shipping Settings
>
> **Slug:** `GIFT_UP_GET_SHIPPING_SETTINGS`
>
> Retrieve the Gift Up account's shipping settings for digital and postal fulfilment. Use the result to inspect available postal shipping options and delivery configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Stripe Connection
>
> **Slug:** `GIFT_UP_GET_STRIPE_CONNECTION`
>
> Tool to retrieve current Stripe integration connection settings. Use when you need to view or audit Stripe payment configuration for the Gift Up account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhook
>
> **Slug:** `GIFT_UP_GET_WEBHOOK`
>
> Tool to retrieve a specific webhook by its ID. Use when you need to get detailed configuration information for a webhook subscription.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique GUID identifier of the webhook to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Gift Card Artwork
>
> **Slug:** `GIFT_UP_LIST_GIFT_CARD_ARTWORK`
>
> Tool to list all gift card artwork available for use on gift cards. Returns artwork information including URLs and sort order. Use when you need to retrieve available gift card designs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Gift Cards
>
> **Slug:** `GIFT_UP_LIST_GIFT_CARDS`
>
> List a page of Gift Up gift cards, optionally filtering by status, creation or update date, and payment transaction ID. Use limit and offset to paginate; the result includes the total matching count and whether more cards are available.
>
> #### Input Parameters
>
> **sku** `string`
>
> Include only gift cards with this private SKU value
>
> **limit** `integer`
>
> Number of gift cards to return; default is 10
>
> **offset** `integer`
>
> Number of gift cards to skip; default is 0
>
> **status** `string ("active" | "expired" | "redeemed" | "voided")`
>
> Include only gift cards in this state
>
> **orderId** `string`
>
> Include only gift cards for this order ID (GUID)
>
> **purchaserEmail** `string`
>
> Include only gift cards with this purchaser email address
>
> **recipientEmail** `string`
>
> Include only gift cards with this recipient email address
>
> **createdOnOrAfter** `string`
>
> Include only gift cards created on or after this UTC datetime (ISO 8601)
>
> **updatedOnOrAfter** `string`
>
> Include only gift cards updated on or after this UTC datetime (ISO 8601)
>
> **paymentTransactionId** `string`
>
> Include only gift cards where the payment provider transaction ID matches
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Item Groups
>
> **Slug:** `GIFT_UP_LIST_ITEM_GROUPS`
>
> Tool to list item groups. Use when you need to retrieve all item groups for filtering items by group.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Items
>
> **Slug:** `GIFT_UP_LIST_ITEMS`
>
> Lists all items (gift cards, passes, etc.) available for sale in the Gift Up account. Items can be optionally filtered by groupId to retrieve only items within a specific group. Use this to discover available items, check item details, pricing, stock levels, and group associations.
>
> #### Input Parameters
>
> **groupId** `string`
>
> Filter to include only items in this group (UUID format). If omitted or invalid, returns all items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Locations
>
> **Slug:** `GIFT_UP_LIST_LOCATIONS`
>
> Retrieves all physical locations where gift cards are sold and/or redeemed. Locations are used exclusively for reporting purposes in Gift Up! to track where gift cards are being distributed and used. This endpoint returns all configured locations for your account, or an empty array if none have been set up. Use this action when you need to: - Get a list of all store/venue locations in your Gift Up! account - Retrieve location IDs for reporting or analytics purposes - Check which physical locations are configured for gift card operations
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Promotions
>
> **Slug:** `GIFT_UP_LIST_PROMOTIONS`
>
> List the Gift Up account's checkout promotions and their details. Use the results to inspect promotion benefits, triggers, usage and limitations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Report Transactions
>
> **Slug:** `GIFT_UP_LIST_REPORT_TRANSACTIONS`
>
> Tool to list report transactions with optional filters. Use after setting desired filters to retrieve transactions report.
>
> #### Input Parameters
>
> **code** `string`
>
> Filter by gift card code.
>
> **limit** `integer`
>
> Number of transactions to return (default 10, max 100).
>
> **users** `array`
>
> Filter by user email address; can be specified multiple times.
>
> **events** `array`
>
> Filter by event type; can be specified multiple times. One of: OrderPlaced, GiftCardCreated, CreditAdded, Redeemed, Expired, Unexpired, Voided, Reactivated.
>
> **offset** `integer`
>
> Number of transactions to skip (default 0).
>
> **locations** `array`
>
> Filter by location id (GUID); can be specified multiple times.
>
> **test\_mode** `boolean`
>
> If true, include header x-giftup-testmode: true to use test mode.
>
> **eventOccurredOnOrAfter** `string`
>
> Include only transactions occurring on or after this UTC datetime.
>
> **eventOccurredOnOrBefore** `string`
>
> Include only transactions occurring on or before this UTC datetime.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List GiftUp Users
>
> **Slug:** `GIFT_UP_LIST_USERS`
>
> Tool to list all users. Use when you need to retrieve all users who have access to your Gift Up! account.
>
> #### Input Parameters
>
> **x\_giftup\_testmode** `boolean`
>
> If true, call runs against test data where supported
>
> **x\_giftup\_displayname** `string`
>
> Overrides display name used in API calls
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `GIFT_UP_LIST_WEBHOOKS`
>
> Tool to list all webhooks configured for the account. Use when you need to view all webhook subscriptions and their configuration details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Health Check (POST)
>
> **Slug:** `GIFT_UP_POST_PING`
>
> Perform a Gift Up API health check by posting an optional test payload to /ping. Use it to test connectivity and authentication; the tool returns an empty object rather than the echoed payload.
>
> #### Input Parameters
>
> **body** `object`
>
> Optional JSON body to send with the ping request. The endpoint echoes it back.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reactivate Gift Card
>
> **Slug:** `GIFT_UP_REACTIVATE_GIFT_CARD`
>
> Tool to reactivate a voided gift card. Use when you need to restore a gift card that has been voided. This operation is only valid for gift cards that have been voided - active or fully redeemed cards cannot be reactivated.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to reactivate
>
> **reason** `string`
>
> The reason for reactivating. Will appear in the gift card history log.
>
> **metadata** `object`
>
> A key-value data store of metadata provided to us by you
>
> **locationId** `string`
>
> The location id where this event occurred at (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Redeem Gift Card
>
> **Slug:** `GIFT_UP_REDEEM_GIFT_CARD`
>
> Redeem a specified currency amount or units from a gift card. Voided cards or cards with insufficient balance cannot be redeemed; the response may contain redemption error flags instead of a successful transaction.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to redeem
>
> **units** `integer`
>
> The number of units to redeem from the gift card (for unit-backed cards). Either amount or units must be provided.
>
> **amount** `string`
>
> The currency amount to redeem from the gift card (for currency-backed cards). Either amount or units must be provided.
>
> **reason** `string`
>
> Optional reason for the redemption (e.g., 'Used with Order 7597')
>
> **metadata** `object`
>
> Optional custom metadata object for tracking purposes (e.g., external order IDs)
>
> **locationId** `string`
>
> Optional location identifier (GUID) where the redemption occurred
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Redeem Gift Card In Full
>
> **Slug:** `GIFT_UP_REDEEM_GIFT_CARD_IN_FULL`
>
> Tool to redeem a gift card in full. Use when you need to deduct the entire remaining balance from a gift card in a single operation.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to redeem
>
> **reason** `string`
>
> The reason for redemption; appears in gift card history
>
> **metadata** `object`
>
> Key-value pairs for custom data storage
>
> **locationId** `string`
>
> Location where the event occurred (GUID)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Subscribe to Webhook
>
> **Slug:** `GIFT_UP_SUBSCRIBE_WEBHOOK`
>
> Subscribe to Gift Up! webhook events to receive real-time notifications about orders and gift cards. This tool registers a callback URL that Gift Up! will POST to when specified events occur. Before creating the subscription, Gift Up! validates the target URL by sending a test POST request with body \{"test": true} and expects a 200 OK response. Use cases: - Receive notifications when orders are created - Track gift card lifecycle events (creation, updates, redemption) - Integrate Gift Up! events with external systems - Build custom automation workflows Note: The target URL must be publicly accessible and capable of responding with 200 OK to the validation request, or the subscription will fail with a 400 error.
>
> #### Input Parameters
>
> **event** `string ("order-created" | "gift-card-created" | "gift-card-updated" | "gift-card-redeemed")` *required*
>
> Type of webhook event to subscribe to. Available events: 'order-created' (triggered when an order is placed), 'gift-card-created' (when a new gift card is created), 'gift-card-updated' (when a gift card is modified), 'gift-card-redeemed' (when a gift card is redeemed).
>
> **secret** `string`
>
> Optional secret key for webhook request signing. When provided, Gift Up! will include an X-Request-Signature-Sha-256 header with each webhook POST, containing a timestamp and HMAC-SHA256 signature for verifying request authenticity.
>
> **targetUrl** `string` *required*
>
> The HTTPS URL where Gift Up! will POST webhook event data. Important: Gift Up! validates this URL by sending a test POST request with body \{"test": true} and expects a 200 OK response. The URL must be publicly accessible and respond to this validation request before the subscription succeeds.
>
> **isTestMode** `boolean`
>
> Set to true to receive only test webhook events. Use this for development and testing without triggering production webhooks. Defaults to false for production events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Top Up Gift Card
>
> **Slug:** `GIFT_UP_TOP_UP_GIFT_CARD`
>
> Top up an existing gift card by code, supplying a positive currency amount and optionally units. Voided gift cards cannot be topped up.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to top up
>
> **units** `integer`
>
> For unit-based gift cards, the number of units to add. Not applicable for currency-backed cards.
>
> **amount** `number` *required*
>
> The monetary amount to add to the gift card balance. Must be greater than 0.
>
> **reason** `string`
>
> Optional reason for topping up this gift card
>
> **metadata** `object`
>
> Optional key-value pairs for custom data associated with this top-up
>
> **locationId** `string`
>
> Optional location identifier where the top-up occurred
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Undo Gift Card Redemption
>
> **Slug:** `GIFT_UP_UNDO_REDEMPTION`
>
> Tool to undo a previous redemption on a gift card, restoring the redeemed amount to the gift card balance. Use when you need to reverse a redemption transaction and restore the gift card balance.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code
>
> **reason** `string`
>
> A text field for providing an optional reason for undoing the redemption.
>
> **metadata** `object`
>
> A key-value object for storing additional custom data.
>
> **transactionId** `string` *required*
>
> The transactionId that you'd like to undo the redemption of. This is returned when redeeming, also available in the ledger property for a Gift Card.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Email Settings
>
> **Slug:** `GIFT_UP_UPDATE_EMAIL_SETTINGS`
>
> Tool to update email settings using JSON Patch operations. Use when you need to modify receipt email content, footer text, sender details, logo settings, or gift card email preferences. This tool allows granular updates to specific email settings properties without replacing the entire configuration. Common use cases include updating footer text, changing sender information, modifying button colors, and adjusting email content.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Array of JSON Patch operations to apply to email settings. Each operation modifies a specific property of the email configuration. Operations are applied sequentially in the order provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Gift Card
>
> **Slug:** `GIFT_UP_UPDATE_GIFT_CARD`
>
> Update a Gift Up gift card by code using JSON Patch operations, for example to change recipient details, expiry dates or terms. After a successful update, the tool retrieves and returns the card.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to update. This is the unique identifier for the gift card.
>
> **operations** `array` *required*
>
> Array of JSON Patch operations to apply to the gift card. Each operation modifies a specific property of the gift card. Operations are applied in order.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Gift Card Settings
>
> **Slug:** `GIFT_UP_UPDATE_GIFT_CARD_SETTINGS`
>
> Tool to update gift card settings using JSON Patch operations. Use when you need to modify code format, expiration rules, or display options for gift cards.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Array of JSON Patch operations to apply to gift card settings. Each operation modifies one property. Multiple operations can be applied in one request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Item
>
> **Slug:** `GIFT_UP_UPDATE_ITEM`
>
> Update an item's properties using JSON Patch operations. Use this to modify item name, price, description, stock levels, availability, and other properties. Supports replace, add, and remove operations for granular field updates.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique GUID identifier of the item to update.
>
> **operations** `array` *required*
>
> List of JSON Patch operations to apply to the item. Each operation modifies a specific field. Common use cases: replace /name to rename, replace /price to change pricing, replace /stocklevel to update inventory, add /codes/- to append redemption codes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Item Group
>
> **Slug:** `GIFT_UP_UPDATE_ITEM_GROUP`
>
> Tool to update an item group's properties using JSON Patch operations. Use when you need to modify name, description, autoExpand, or sortOrder fields of an existing item group.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The GUID identifier of the item group to update
>
> **operations** `array` *required*
>
> Array of JSON Patch operations to apply. Each operation modifies a specific property of the item group
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Order
>
> **Slug:** `GIFT_UP_UPDATE_ORDER`
>
> Update an order's properties using JSON Patch replace operations, such as changing the purchaser's name or email.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the order to update (GUID format or order number)
>
> **operations** `array` *required*
>
> List of JSON Patch operations to apply to the order
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Stripe Connection
>
> **Slug:** `GIFT_UP_UPDATE_STRIPE_CONNECTION`
>
> Update Gift Up Stripe connection settings, including API keys, Connect settings and payment methods. Live public and secret keys are required; the response includes connection test results.
>
> #### Input Parameters
>
> **enableEps** `boolean`
>
> Enable EPS payment method (popular in Austria).
>
> **enableFpx** `boolean`
>
> Enable FPX payment method (popular in Malaysia).
>
> **enablePix** `boolean`
>
> Enable Pix payment method (popular in Brazil).
>
> **enableZip** `boolean`
>
> Enable Zip buy-now-pay-later payment method.
>
> **enableBlik** `boolean`
>
> Enable Blik payment method (popular in Poland).
>
> **enableIdeal** `boolean`
>
> Enable iDEAL payment method (popular in the Netherlands).
>
> **enableAffirm** `boolean`
>
> Enable Affirm buy-now-pay-later payment method (US only).
>
> **enableAlipay** `boolean`
>
> Enable Alipay payment method (popular in China).
>
> **enableKlarna** `boolean`
>
> Enable Klarna buy-now-pay-later payment method.
>
> **enablePayNow** `boolean`
>
> Enable PayNow payment method (popular in Singapore).
>
> **enablePayPal** `boolean`
>
> Enable PayPal payment method.
>
> **enableWeChat** `boolean`
>
> Enable WeChat Pay payment method (popular in China).
>
> **reviewAction** `string ("Continue" | "WaitForApproval")`
>
> Action to take when Stripe flags a payment for review. 'Continue' auto-captures flagged payments; 'WaitForApproval' requires manual review.
>
> **enableCashApp** `boolean`
>
> Enable Cash App Pay payment method (US only).
>
> **enableGiropay** `boolean`
>
> Enable Giropay payment method (popular in Germany).
>
> **enableGrabPay** `boolean`
>
> Enable GrabPay payment method (popular in Southeast Asia).
>
> **livePublicKey** `string` *required*
>
> Your Stripe live publishable API key (must start with pk\_live\_)
>
> **liveSecretKey** `string` *required*
>
> Your Stripe live secret API key (must start with sk\_live\_ or rk\_live\_)
>
> **testPublicKey** `string`
>
> Your Stripe test publishable API key
>
> **testSecretKey** `string`
>
> Your Stripe test secret API key
>
> **enableMobilePay** `boolean`
>
> Enable MobilePay payment method (popular in Denmark and Finland).
>
> **enablePromptPay** `boolean`
>
> Enable PromptPay payment method (popular in Thailand).
>
> **connectAccountId** `string`
>
> Stripe Connect account ID for receiving payments. Use this for marketplace/platform integrations.
>
> **enableBancontact** `boolean`
>
> Enable Bancontact payment method (popular in Belgium).
>
> **enableMultibanco** `boolean`
>
> Enable Multibanco payment method (popular in Portugal).
>
> **enablePrzelewy24** `boolean`
>
> Enable Przelewy24 payment method (popular in Poland).
>
> **askForFullAddress** `boolean`
>
> When true, collects complete billing address from customers at checkout.
>
> **useStripeCheckout** `boolean`
>
> Enable Stripe's hosted checkout experience instead of inline payment forms.
>
> **applicationFeeFixed** `number`
>
> Platform flat fee amount in account currency. Only applicable with Stripe Connect.
>
> **statementDescriptor** `string`
>
> Text that appears on customer bank statements (max 22 characters)
>
> **threeDSecureRequired** `boolean`
>
> When true, enforces 3D Secure (3DS) authentication for liability shift protection. Recommended for reducing fraud risk on card payments.
>
> **createCustomerAccounts** `boolean`
>
> When true, creates Stripe Customer objects for buyers to improve fraud detection and enable features like saved payment methods.
>
> **enableAfterpayClearpay** `boolean`
>
> Enable Afterpay/Clearpay buy-now-pay-later payment method.
>
> **applicationFeePercentage** `number`
>
> Platform fee as a percentage (e.g., 5 for 5%). Only applicable with Stripe Connect.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Gift Card Artwork
>
> **Slug:** `GIFT_UP_UPLOAD_ARTWORK`
>
> Upload new gift card artwork from an image URL.
>
> #### Input Parameters
>
> **Url** `string` *required*
>
> URL of the artwork image to upload. The image must be at least 576x384 pixels (recommended 1152x768 or higher for high-resolution displays). Supported formats: PNG, GIF, JPG.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Void Gift Card
>
> **Slug:** `GIFT_UP_VOID_GIFT_CARD`
>
> Void a gift card by code so it cannot be redeemed while voided. An already voided gift card cannot be voided again.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> The gift card code to void
>
> **reason** `string`
>
> The reason for voiding. Will appear in the gift card history log.
>
> **metadata** `object`
>
> Key-value data store for your custom metadata
>
> **locationId** `string`
>
> Location where the void event occurred (UUID format)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
