# Token Codes

What are Token Codes?

A token code is a **link** or **QR Code** that directs a user to the P00LS app to redeem their tokens in their account.&#x20;

Each token code has a specific number of **Redeems** and **Tokens Earned** per redeem.&#x20;

The number of redeems is equal to the number of people who can earn the tokens. Each code allows one redeem per person.&#x20;

Each redeem earns a specific number of tokens.&#x20;

**Example:** One redeem earns 100 tokens. One token code has 50 redeems available.&#x20;

## How to Use Token Codes

Links are best shared on digital platforms, such as on social media, pinned at the top of Twitter Spaces, DM's, in emails, or in chat rooms.&#x20;

QR codes are best for in-person distribution, such as on your phone, printed on posters/cards, or projected on screens. &#x20;

## How to Create Token Codes

**Step 1:** Log in to the Creator Portal

**Step 2:** Click on **`Codes`**

<div align="left"><figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FPJX5XdULSoD3IQS5JZ8f%2Fimage.png?alt=media&#x26;token=baf1b5c8-bc35-409b-9f0c-819de21258b0" alt="" width="139"><figcaption></figcaption></figure></div>

**Step 3:** Select the **`Create Code`** button in the upper right corner

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FnNO8WartSMN4fOKQSdTM%2FImage%207-24-24%20at%205.10%E2%80%AFPM.jpeg?alt=media&#x26;token=4c737d30-f311-4a10-99f7-7521ac99aa8b" alt=""><figcaption></figcaption></figure>

**Step 4:** Set Up Your Code

* Add a **`Name`**&#x20;
  * This will be displayed publically
* Select a **`Reward Size`**
  * These are the same sizes you can select for weekly rewards, however you also have the option to select Custom, and add a custom reward amount to distribute per redeem
* Add how many **`Available Redemptions`** you'd like available on this code
  * Remember: Redeems = the number of people who can earn tokens from this code. One redeem per wallet allowed

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FVbasAn4Ie3qVV7xVLnFG%2FImage%207-24-24%20at%205.11%E2%80%AFPM.jpeg?alt=media&#x26;token=e4db09e3-16bf-4350-aac9-9a6677f667bd" alt=""><figcaption></figcaption></figure>

**Step 5:** Share Your Code!

* Under the token name, you can select&#x20;
  * Select URL - this will provide you with a link
  * QR Code - this will open a QR code that can be scanned by users to access the redeem code

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2F066e6Q43tIufpHDZiBtB%2FImage%207-24-24%20at%205.12%E2%80%AFPM.jpeg?alt=media&#x26;token=b9d58c16-1b1f-4327-aeca-3b9c4e64a3ad" alt=""><figcaption></figcaption></figure>

## How Do Users Redeem Their Codes

**Step 1:** Users click the **`Link`** or scan the **`QR Code`**

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2F9TIBNloSZJ5y01OznnbT%2FImage%207-24-24%20at%205.13%E2%80%AFPM.jpeg?alt=media&#x26;token=10eea6b1-4c4c-4978-8e50-64da49820ea3" alt=""><figcaption></figcaption></figure>

**Step 2: `Connect their wallet`** to redeem the tokens to their wallet

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FoNqoXANZDWtTbMMopS8J%2FImage%207-24-24%20at%205.14%E2%80%AFPM.jpeg?alt=media&#x26;token=383b2813-ad0a-4171-b635-3c1206980ac5" alt=""><figcaption></figcaption></figure>

**Step 3:**  **`Approve The Transaction`** of tokens to wallet

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FXXS1GYGYkV30nhw3xpN5%2FImage%207-24-24%20at%205.14%E2%80%AFPM%20(1).jpeg?alt=media&#x26;token=2f5e5539-59de-4be2-b7c9-8c2fec8cad6e" alt=""><figcaption></figcaption></figure>

**Step 4:** User is all set! Tokens can take 5-30 minutes to send to your wallet.&#x20;

<figure><img src="https://2746209650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1AIubaMR9SS5e4227oAx%2Fuploads%2FZLWeWUDpuvhuSbL9WheN%2FImage%207-24-24%20at%205.15%E2%80%AFPM%20(1).jpeg?alt=media&#x26;token=7752c157-be9d-459a-a8b8-9234e04a132d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://p00ls.gitbook.io/p00ls-v2/token-distribution/token-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
