---
updatedAt: 2025-12-25T12:42:17.000Z
agentTools:
  projectIndex: https://loyaltyapi.yotpo.com/llms.txt
---

# Authentication

How to authenticate with the Yotpo Loyalty API using your GUID and API key.

## 🔐 Authentication

Yotpo uses a combination of your **`GUID`** and **`API Key`** to authenticate all API requests.

You can find your credentials in your [Loyalty settings](https://loyalty-app.yotpo.com/settings).

Need help finding your API credentials? [Click here for instructions](https://support.yotpo.com/docs/finding-your-loyalty-referrals-api-key-and-guid)

***

## 🔧 Authentication via HTTP headers

When authorizing requests with headers:

* Set the `Content-Type` to `application/json`
* Pass both the `GUID` and `API Key` in custom headers

### Required headers

| Header         | Example Value              | Notes                            |
| -------------- | -------------------------- | -------------------------------- |
| `Content-Type` | `application/json`         | Required for JSON payloads       |
| `X-GUID`       | `6lC7NrMa4zw2v_fqFf-rQf`   | Replace with your actual GUID    |
| `X-API-KEY`    | `iO6OZc37hEVTRgckKYphXAtt` | Replace with your actual API key |

***

## 🔗 Authentication via query parameters

You can also authenticate by passing your credentials as **query parameters**:

```http
GET /v1/customers?guid=6lC7NrMa4zw2v_fqFf-rQf&api_key=iO6OZc37hEVTRgckKYphXAtt

# Sibling pages

- [Welcome](https://loyaltyapi.yotpo.com/reference/welcome.md)
- [Guidelines & Conventions](https://loyaltyapi.yotpo.com/reference/guidelines-and-conventions.md)


# What’s Next

Explore the available endpoints for managing your loyalty program
```