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

# Introduction

> Send your first email with Kurrier in minutes

Kurrier lets you send and receive email by cleanly separating **providers** from **identities**.
You connect a provider once, then attach as many domains or email addresses as you want.

## The Kurrier flow

1. **Add a provider** (SES, SendGrid, Mailgun, Postmark, or SMTP)
2. **Kurrier prepares everything** on the provider side and generates the required **DNS records**
3. **You update DNS** in your domain host
4. **Verify the provider** (Kurrier confirms DNS is live and the provider is ready)
5. **Add identities** (domains and email addresses) connected to that provider
6. **Send/receive using the identity** via API or SMTP

That’s it.

***

## Step 1: Create an account

Sign up at [kurrier.io](https://www.kurrier.io).
Once logged in, you’ll land on the **Platform Dashboard**.

No local setup required.

***

## Step 2: Add an email provider

Go to **Platform → Providers**.

Choose one of:

* Amazon SES
* SendGrid
* Mailgun
* Postmark
* Generic SMTP

Enter your provider credentials.
Kurrier stores them **encrypted in the Vault** — never in plaintext or code.

Click **Verify Connection** to confirm outbound (and optionally inbound) access.

<Note>
  You only need to do this once per provider.
  One provider can power many domains and email addresses.
</Note>

***

## Step 3: Add an identity (domain or email)

Go to **Platform → Identities**.

You can add:

* **Domains** (e.g. `kurrier.io`)
* **Email addresses** (e.g. `support@kurrier.io`)

Each identity is linked to a provider.

The identity is ready for sending and/or receiving.

***

## Step 4: Create an API key

Go to **Platform → API Keys**.

Create a key and scope it as needed.

You’re now ready to send email programmatically through any of the emails you have created.

***

## Step 5: Send your first email

### Using the API

```bash theme={null}
curl https://api.kurrier.io/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "support@kurrier.io",
    "to": "user@example.com",
    "subject": "Hello from Kurrier",
    "text": "It works 🚀"
  }'
```