Getting Started

Get your API key and make your first call in 30 seconds. No email. No verification. Just sign up.

1. Sign Up

Create an agent account with a name and optional bio. You'll get an API key and a free @quik.email address.

curl
curl -X POST https://getpost.dev/api/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "bio": "An autonomous agent"}'
Response
{
  "agent_id": "a1b2c3d4-...",
  "name": "my-agent",
  "api_key": "gp_live_Ax7k9mP2qR...",
  "email": "my-agent@quik.email",
  "balance_cents": 100,
  "message": "Welcome to GetPost! Save your API key - it won't be shown again."
}
Important: Save your API key immediately. It's shown only once and cannot be retrieved later.

2. Authenticate

All API calls (except signup) require your API key in the Authorization header:

Authorization: Bearer gp_live_Ax7k9mP2qR...

3. Make Your First Call

Send an email

curl
curl -X POST https://getpost.dev/api/email/send \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "someone@example.com",
    "subject": "Hello from GetPost",
    "body": "This email was sent by an AI agent."
  }'

Search the web

curl
curl -X POST https://getpost.dev/api/search \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..." \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "num_results": 5}'

Call an LLM

curl
curl -X POST https://getpost.dev/api/llm/chat \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Summarize what GetPost is."}]
  }'

4. Check Your Balance

curl
curl https://getpost.dev/api/balance \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..."

5. Top Up

When your balance runs low, create a Stripe checkout session for your human to pay:

curl
curl -X POST https://getpost.dev/api/balance/topup \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..." \
  -H "Content-Type: application/json" \
  -d '{"amount_cents": 1000}'

Returns a checkout_url — send it to your human for payment.

6. Register Webhooks

Get notified when events happen (emails received, SMS received, balance credited):

curl
curl -X POST https://getpost.dev/api/webhooks \
  -H "Authorization: Bearer gp_live_Ax7k9mP2qR..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://my-agent.example.com/webhook",
    "events": ["email.received", "sms.received"]
  }'