Skip to main content
This guide walks you from a fresh account to your first successful API call in under three minutes. Everything below uses curl for clarity; the same requests work in any HTTP client.

​
Prerequisites

​
Step 1 — Get an API token

Open Settings → API and click Create token. Copy the value — we never show it twice. 
export STACKRYZE_TOKEN="sk_live_..."

​
Step 2 — Make your first call

List all the zones in your account: 
curl https://api.stackryze.com/v1/zones \
  -H "Authorization: Bearer $STACKRYZE_TOKEN"
A successful response looks like: 
{
  "data": [
    {
      "id": "8c2e…",
      "name": "example.com",
      "status": "active",
      "record_count": 12,
      "created_at": "2026-06-12T08:23:11Z"
    }
  ],
  "next_cursor": null
}

​
Step 3 — Add a record

curl -X POST https://api.stackryze.com/v1/zones/example.com/records \
  -H "Authorization: Bearer $STACKRYZE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "A",
    "name": "@",
    "value": "192.0.2.1",
    "ttl": 300
  }'

​
Step 4 — Verify the change

curl https://api.stackryze.com/v1/zones/example.com/records \
  -H "Authorization: Bearer $STACKRYZE_TOKEN" | jq '.data[].name'
Or run a public lookup: 
dig +short @ns1.stackryze.com example.com

​
Next steps

  • Browse the full API surface — every endpoint the dashboard exposes
  • Subscribe to webhook events — see Webhooks
  • Generate SDKs with openapi-generator-cli against our OpenAPI spec
Hit a rate limit? Free accounts get 60 req/min, verified accounts 600 req/min, Pro 6,000 req/min.