# Gift Up API Documentation

This is the complete API documentation for connecting to the Gift Up API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Gift Up connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/giftUp/actions/{actionSlug}/run
```

## Gift Up actions

- POST `create-item` Create Item
- POST `create-item-group` Create Item Group
- POST `create-order` Create Order
- GET `get-company` Get Company
- GET `get-gift-card-by-code` Get Gift Card by Code
- GET `get-item-by-id` Get Item by ID
- GET `get-item-group-by-id` Get Item Group by ID
- GET `get-order-by-id` Get Order by ID
- GET `get-report-transaction` Get Report Transaction
- GET `list-gift-cards` List Gift Cards
- GET `list-item-groups` List Item Groups
- GET `list-items` List Items
- GET `list-locations` List Locations
- GET `list-report-transactions` List Report Transactions
- PUT `reactivate-gift-card` Reactivate Gift Card
- PUT `redeem-gift-card` Redeem Gift Card
- PUT `redeem-gift-card-in-full` Redeem Gift Card in Full
- PUT `top-up-gift-card` Top Up Gift Card
- PUT `transfer-gift-card-balances` Transfer Gift Card Balances
- PUT `undo-gift-card-redemption` Undo Gift Card Redemption
- PUT `update-gift-card` Update Gift Card
- PUT `update-item` Update Item
- PUT `update-item-group` Update Item Group
- PUT `void-gift-card` Void Gift Card