Gift Up!
gift_upGift 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.
Acciones disponibles (9)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Get Checkout SettingsGIFT_UP_GET_CHECKOUT_SETTINGSAcciónTool to retrieve the current checkout settings. Use when you need to display or audit your checkout configuration.
GIFT_UP_GET_CHECKOUT_SETTINGSAcciónTool to retrieve the current checkout settings. Use when you need to display or audit your checkout configuration.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Company DetailsGIFT_UP_GET_COMPANYAcciónTool to retrieve company details. Use when you need to fetch the current company associated with the API key.
GIFT_UP_GET_COMPANYAcciónTool to retrieve company details. Use when you need to fetch the current company associated with the API key.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Gift CardsGIFT_UP_LIST_GIFT_CARDSAcciónTool to list gift cards. Use when you need to retrieve gift cards with optional filters.
GIFT_UP_LIST_GIFT_CARDSAcciónTool to list gift cards. Use when you need to retrieve gift cards with optional filters.
Parámetros de entrada
skustringInclude only gift cards with this private SKU value
limitintegerNumber of gift cards to return; default is 10
offsetintegerNumber of gift cards to skip; default is 0
statusstringenumInclude only gift cards in this state
activeexpiredredeemedvoidedorderIdstringInclude only gift cards for this order ID (GUID)
purchaserEmailstringemailInclude only gift cards with this purchaser email address
recipientEmailstringemailInclude only gift cards with this recipient email address
createdOnOrAfterstringdate-timeInclude only gift cards created on or after this UTC datetime (ISO 8601)
updatedOnOrAfterstringdate-timeInclude only gift cards updated on or after this UTC datetime (ISO 8601)
paymentTransactionIdstringInclude only gift cards where the payment provider transaction ID matches
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Item GroupsGIFT_UP_LIST_ITEM_GROUPSAcciónTool to list item groups. Use when you need to retrieve all item groups for filtering items by group.
GIFT_UP_LIST_ITEM_GROUPSAcciónTool to list item groups. Use when you need to retrieve all item groups for filtering items by group.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List ItemsGIFT_UP_LIST_ITEMSAcciónTool to list items. Use when you need to retrieve all items available for sale, optional filter by groupId.
GIFT_UP_LIST_ITEMSAcciónTool to list items. Use when you need to retrieve all items available for sale, optional filter by groupId.
Parámetros de entrada
groupIdstringInclude only items in this group (UUID)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List LocationsGIFT_UP_LIST_LOCATIONSAcciónTool to list all locations. Use when you need to retrieve all locations associated with the account.
GIFT_UP_LIST_LOCATIONSAcciónTool to list all locations. Use when you need to retrieve all locations associated with the account.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Report TransactionsGIFT_UP_LIST_REPORT_TRANSACTIONSAcciónTool to list report transactions with optional filters. Use after setting desired filters to retrieve transactions report.
GIFT_UP_LIST_REPORT_TRANSACTIONSAcciónTool to list report transactions with optional filters. Use after setting desired filters to retrieve transactions report.
Parámetros de entrada
codestringFilter by gift card code.
limitintegerNumber of transactions to return (default 20).
usersstring[]Filter by user email address; can be specified multiple times.
eventsstring[]Filter by event type; can be specified multiple times. One of: OrderPlaced, GiftCardCreated, CreditAdded, Redeemed, Expired, Unexpired, Voided, Reactivated.
offsetintegerNumber of transactions to skip (default 0).
locationsstring[]Filter by location id (GUID); can be specified multiple times.
test_modebooleanIf true, include header x-giftup-testmode: true to use test mode.
eventOccurredOnOrAfterstringdate-timeInclude only transactions occurring on or after this UTC datetime.
eventOccurredOnOrBeforestringdate-timeInclude only transactions occurring on or before this UTC datetime.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List GiftUp UsersGIFT_UP_LIST_USERSAcciónTool to list all users. Use when you need to retrieve all users who have access to your Gift Up! account.
GIFT_UP_LIST_USERSAcciónTool to list all users. Use when you need to retrieve all users who have access to your Gift Up! account.
Parámetros de entrada
x_giftup_testmodebooleanIf true, call runs against test data where supported
x_giftup_displaynamestringOverrides display name used in API calls
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Subscribe to WebhookGIFT_UP_SUBSCRIBE_WEBHOOKAcciónTool to subscribe to a Gift Up! webhook event. Use when you need to register a callback URL for specific account events.
GIFT_UP_SUBSCRIBE_WEBHOOKAcciónTool to subscribe to a Gift Up! webhook event. Use when you need to register a callback URL for specific account events.
Parámetros de entrada
eventstringObligatorioenumType of webhook event to subscribe to. Supported: order-created, gift-card-created, gift-card-updated, gift-card-redeemed.
order-createdgift-card-createdgift-card-updatedgift-card-redeemedsecretstringOptional secret used to sign webhook requests.
targetUrlstringObligatoriouriThe URL to which Gift Up! will POST webhook events.
isTestModebooleanIf true, only test webhooks will be sent.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not