> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supernormal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use Supernormal’s REST API to create custom integrations, or scripts.

## Base URL

```
https://api.supernormal.com/api/v1
```

## Authentication

1. Head to your [account settings](https://app.supernormal.com/settings) and click on **API keys**
2. Click on **Create API key**
3. Enter a descriptive name and choose the minimum set of scopes you need for your integrations
4. Create and copy the generated token
5. Send that token in your API headers e.g. `X-API-TOKEN: YOUR_TOKEN`

## Making requests

Include your token and a `Content-Type: application/json` header with all requests. Example:

```
curl \
 --url https://api.supernormal.com/api/v1/user \
 --header 'X-API-TOKEN: <YOUR_API_TOKEN>' \
 --header 'Content-Type: application/json'
```