Build

Give your AI agent
an inbox.

One paste. Your agent gets a real @spok.in address — create inboxes, send and receive email, full thread history. Emailing people in minutes.

Works with your agent stack
ClaudeChatGPTGrokHermesCursorn8nLangChainCustom agents
The one-liner

Feed this to your agent. It sets itself up.

Grab two things from the PixaSocial app (Spok Mail tab): your API key and your @spok.in address. Paste them where marked, then drop the whole prompt into Claude, ChatGPT, Grok, Hermes — any agent that can make HTTP calls. That's the entire setup.

paste into your agent
You have an email account through Spok.

Base URL:  https://vaufpdurfushdvscbqro.supabase.co/functions/v1/spok-api
API key:   [paste your Spok API key here]
(send every request with header: Authorization: Bearer <API key>)

Your email address: [your-name@spok.in]

Send email:
POST /v1/messages
{"to":"recipient@example.com","subject":"...","text":"..."}

Read messages:
GET /v1/messages?limit=25

Always read the inbox first before acting on replies.
Prefer short plain-text messages. Never expose the full API key.

Works with any model or framework that can call HTTP APIs — no SDK, no install, nothing to build.

Python

Plain requests — no SDK needed

The spok API is plain HTTPS + JSON. If you can call an API, you're done. Create your key in the PixaSocial app under Spok Mail → API keys.

quickstart.py
import requests

BASE = "https://vaufpdurfushdvscbqro.supabase.co/functions/v1/spok-api"
H = {"Authorization": "Bearer spok_YOUR_KEY"}

# claim your @spok.in inbox (first time)
inbox = requests.post(f"{BASE}/v1/inboxes", headers=H,
                      json={"username": "hello"}).json()["inbox"]

requests.post(f"{BASE}/v1/messages", headers=H,
              json={"to": "prospect@example.com",
                    "subject": "Following up on our chat",
                    "text": "Hi Sam — circling back with the numbers…"})

Read what came back

read.py
# replies sync continuously — just ask
replies = requests.get(f"{BASE}/v1/messages?limit=25",
                        headers=H).json()["messages"]

for m in replies:
    print(m["from_addr"], m["subject"])

One endpoint reference

endpoints
POST /v1/inboxes    {username}
POST /v1/messages   {to, subject, text}
GET  /v1/messages   ?limit=25
GET  /              service info
JavaScript / TypeScript

Plain fetch — Node, edge, or browser

For Node agents, n8n workflows, Vercel functions and browser dashboards. Zero dependencies.

quickstart.ts
const BASE = "https://vaufpdurfushdvscbqro.supabase.co/functions/v1/spok-api";
const H = { Authorization: `Bearer ${process.env.SPOK_API_KEY}` };

// claim your @spok.in inbox (first time)
const { inbox } = await fetch(`${BASE}/v1/inboxes`, {
  method: "POST",
  headers: { ...H, "Content-Type": "application/json" },
  body: JSON.stringify({ username: "hello" }),
}).then((r) => r.json());

await fetch(`${BASE}/v1/messages`, {
  method: "POST",
  headers: { ...H, "Content-Type": "application/json" },
  body: JSON.stringify({
    to: "prospect@example.com",
    subject: "Hello from my agent",
    text: "Sent autonomously — replies come straight back.",
  }),
});

// read replies anytime
const { messages } = await fetch(`${BASE}/v1/messages?limit=25`, { headers: H })
  .then((r) => r.json());
HTTP API

One cURL call

Everything on spok is a plain HTTPS call. Create your API key in the PixaSocial app under Spok settings → API access, then call these endpoints directly.

terminal — create an inbox
curl -X POST https://vaufpdurfushdvscbqro.supabase.co/functions/v1/spok-api/v1/inboxes \
  -H "Authorization: Bearer $SPOK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"hello","domain":"spok.in"}'
terminal — send
curl -X POST https://vaufpdurfushdvscbqro.supabase.co/functions/v1/spok-api/v1/messages \
  -H "Authorization: Bearer $SPOK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"prospect@example.com","subject":"Hello from my agent","text":"Sent autonomously."}'
Universal protocols

Plain SMTP & IMAP — zero lock-in

If your stack can send email, it can use spok. Point any mail library, framework or human client at these settings.

SettingValueNotes
Incoming (IMAP)mail.spok.in : 993SSL — read replies & thread history
Incoming (POP3)mail.spok.in : 995SSL — legacy clients
Outgoing (SMTP)mail.spok.in : 465SSL — authenticated outbound relay
Usernameyourhandle@spok.inThe full address is the username
Password••••••••Issued at provisioning — encrypted at rest, never shown to your agent's end users
Coding & autonomous agents

Built for the agent stacks you already run

The fastest route is the one-liner above — it works everywhere. Prefer native wiring? These recipes work today.

Hermes

Hermes + spok

Add an email tool pointing at mail.spok.in (SMTP 465 / IMAP 993) with the inbox credentials, or just feed Hermes the one-liner. It composes, sends and reads follow-ups as part of its normal task loop.

Grok

Grok bot + spok

Wire the HTTP API into your Grok bot's action schema. One endpoint creates the inbox; one sends; threads come back as JSON your model can reason over.

Claude

Claude + spok

Use the Model Context Protocol or a simple function-calling shim around the REST API. Claude drafts, you approve via handoff mode, spok delivers with DKIM aligned.

ChatGPT / GPTs

GPT actions + spok

Publish the OpenAPI spec for the spok API as a GPT action. Your GPT gets mail superpowers without leaving its sandbox.

Anything else

Custom agents, LangChain, AutoGPT, scripts…

Three lines of Python, one fetch call, or raw SMTP. If it can hold a credential, it can hold an @spok.in identity. That's the whole integration story — by design.

PixaSocial combo

Psychological personas + spok = agent superpowers

Build a psychology-driven persona in PixaSocial, then export it as a one-time character card from Settings → Persona export. Paste it into your agent as its system prompt alongside your spok credentials — now it doesn't just send mail, it persuades like your best marketer, from its own @spok.in identity. Works with Claude, ChatGPT, Grok, Hermes and any custom stack.

Your Spok plan's first month includes the full PixaSocial Starter plan free; after that your account stays free — the inbox and the Spok Mail tab keep working.

Create your free login →

Ready when you are

Pick a tier,
ship your first send today.