> For the complete documentation index, see [llms.txt](https://docs.claimr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.claimr.io/codes/gift-codes.md).

# Gift codes

## Benefits of using gift codes

Import and manage your own gift codes to distribute to users as rewards for completing tasks, quests, or participating in your campaigns.&#x20;

* **Unique codes:** Each gift code should be unique and can only be used once.
* **Security:** Ensure that your gift codes are securely stored and managed to prevent unauthorized access or misuse.
* **Tracking:** claimr tracks which user received each gift code, allowing you to monitor distribution and usage.

## **Creating a gift code list**

1. **Access the Gift codes section:** Navigate to the **Events** section in the claimr admin panel and select the **Gift Codes** tab.
2. **Create a new gift code list:** Click <mark style="color:green;">**Create**</mark> to set a new list of gift codes.
3. **Define gift Code details:**

<figure><img src="/files/emMCxABF450nvh3l7KSU" alt="" width="375"><figcaption><p>Gift code settings</p></figcaption></figure>

* **Gift codes type:** Provide a descriptive name or category for the type of gift codes you're adding (e.g., "10% Discount," "Free Trial").
* **Codes:** Enter the gift codes you want to include in the list. You can manually enter each code or import them from a CSV or TXT file.

4. **Save the Gift Code List:** Click the "Create" button to save the new gift code list.

### **Managing gift codes**

<figure><img src="/files/L1Xj58LL2TIVb3ZkUHp2" alt=""><figcaption><p>Gift code pannel</p></figcaption></figure>

claimr provides a table in the Gift Codes section to manage your gift code lists. This table includes information such as:

* **Code:** The actual gift code.
* **Type:** The type or category of the gift code.
* **Date:** The date and time the gift code was added.
* **Owner:** The user who owns or is associated with the gift code.

You can use the buttons above the table to:

* **Export .csv file:** Export the list of gift codes as a CSV file.
* **Delete:** Delete selected gift code lists.

## **Distributing gift codes**

To distribute gift codes to users, you need to configure them as rewards within your claimr campaign.

1. **Navigate to the Rewards section:** Go to the **Rewards** section in your campaign settings.
2. **Create a new reward:** Click the "Create Reward" button.
3. **Select gift code type:** Choose "Gift Code" as the reward type.
4. **Choose gift Code list:** Select the specific gift code list you want to use for this reward.
5. **Configure reward settings:** Set the reward name, quantity, and any other relevant settings.
6. **Save the reward:** Click the "Create" button to save the new reward.

Now, when users earn this reward, they will receive a gift code from your list.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.claimr.io/codes/gift-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
