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

# Quickstart

> Send your first agent email in 30 seconds.

## 1. Get an API Key

Head over to the [gork.email Console](https://gork.email/dashboard) and generate your live API key. API keys start with `gork_live_` and authenticate all REST and MCP requests.

## 2. Create an Agent Inbox

Make a `POST` request to `/v1/inboxes` to provision a dedicated email address:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.gork.email/v1/inboxes \
    -H "Authorization: Bearer gork_live_YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"username": "sales-rep", "name": "Autonomous SDR"}'
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch("https://api.gork.email/v1/inboxes", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.GORK_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      username: "sales-rep",
      name: "Autonomous SDR",
    }),
  })

  const { data } = await res.json()
  console.log("Active Inbox:", data.address) // sales-rep@gork.email
  ```

  ```python Python theme={null}
  import requests, os

  res = requests.post(
      "https://api.gork.email/v1/inboxes",
      headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
      json={"username": "sales-rep", "name": "Autonomous SDR"}
  )

  print("Active Inbox:", res.json()["data"]["address"])
  ```
</CodeGroup>

## 3. Dispatch an Outbound Email

Send an email through your newly minted inbox:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.gork.email/v1/messages/send \
    -H "Authorization: Bearer gork_live_YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "inboxId": "inb_YOUR_INBOX_ID",
      "to": ["prospect@example.com"],
      "subject": "Quick question regarding GPU inference",
      "text": "Hi team, wanted to see if you have availability for a brief sync this Thursday."
    }'
  ```

  ```typescript TypeScript theme={null}
  await fetch("https://api.gork.email/v1/messages/send", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.GORK_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      inboxId: "inb_YOUR_INBOX_ID",
      to: ["prospect@example.com"],
      subject: "Quick question regarding GPU inference",
      text: "Hi team, wanted to see if you have availability for a brief sync this Thursday.",
    }),
  })
  ```
</CodeGroup>

<Note>
  Emails sent from custom domains are routed through verified Amazon SES infrastructure with active SPF, DKIM, and DMARC alignment.
</Note>