Docs Getting Started

Getting Started

From zero to your first API call in under 5 minutes. Follow these steps to set up your RocketStack account.

1

Create Your Account

Sign up for free at the RocketStack console. No credit card required.

Open Console
Takes about 30 seconds

You can sign up with:

Email GitHub (Coming soon) Google (Coming soon)
2

Explore Your Dashboard

Once logged in, you'll see the developer console. Here's what you'll find:

API Catalog

Browse all available primitives

Subscriptions

Manage your API subscriptions

Applications

Create and manage API keys

Usage

Monitor API calls and quotas

3

Subscribe to APIs

All six primitives are available on the free tier with generous quotas for development.

Free Tier Includes

Functions, Queue, Storage, KV, Cron, and Scheduler — all included with your account.

To subscribe to an API with expanded limits:

  1. Go to API Catalog in the console
  2. Click on the API you want to use
  3. Click Subscribe to add it to your account
4

Generate API Keys

Create an application to get your API key for authentication.

  1. Navigate to Applications in the sidebar
  2. Click Create Application
  3. Enter a name (e.g., "My App - Development")
  4. Copy your API key immediately

Important

Your API key is only shown once. Store it securely — we recommend using environment variables.

.env
ROCKETSTACK_API_KEY=rs_live_xxxxxxxxxxxx
5

Make Your First API Call

Let's store a value in KV to test your setup. Replace the API key with your own.

PUT/kv/items/user-123
curl -X PUT https://api.rocketstack.dev/kv/items/user-123 \
  -H "Authorization: Bearer rs_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"value": {"name": "John", "email": "john@example.com"}}'
Response 200 OK
{
  "requestId": "...",
  "data": { "key": "user-123", "version": "...", "expiresAt": null }
}

That's it! You've successfully stored data in RocketStack. Explore the full API reference →

6

Monitor Your Usage

Track your API consumption and stay within quotas using the Usage dashboard.

Request counts

Response times

Error rates

Set up usage alerts to get notified before hitting your limits.

7

MCP Integration

Optional

Deploy and manage Functions directly from AI assistants like Claude, Cursor, or Windsurf using the Model Context Protocol.

AI-Powered Deployment

Just ask your AI to "deploy my webhook handler" — it handles the rest automatically.

Add this to your MCP client configuration:

mcp_config.json
{
  "mcpServers": {
    "rocketstack": {
      "command": "npx",
      "args": ["-y", "@rocketstack/mcp-server"],
      "env": {
        "ROCKETSTACK_API_KEY": "rs_live_xxxx"
      }
    }
  }
}
Works with:
Claude Cursor Windsurf

Learn more about MCP integration →

Best Practices

Secure Your Keys

Never commit keys to git. Use environment variables.

Rotate Regularly

Use different keys for dev/prod. Rotate periodically.

Handle Errors

Implement retry logic with exponential backoff.

Set Up Alerts

Get notified before hitting quota limits.

Next Steps