Getting Started
From zero to your first API call in under 5 minutes. Follow these steps to set up your RocketStack account.
Create Your Account
Sign up for free at the RocketStack console. No credit card required.
You can sign up with:
Explore Your Dashboard
Once logged in, you'll see the developer console. Here's what you'll find:
Browse all available primitives
Manage your API subscriptions
Create and manage API keys
Monitor API calls and quotas
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:
- Go to API Catalog in the console
- Click on the API you want to use
- Click Subscribe to add it to your account
Generate API Keys
Create an application to get your API key for authentication.
- Navigate to Applications in the sidebar
- Click Create Application
- Enter a name (e.g., "My App - Development")
- Copy your API key immediately
Important
Your API key is only shown once. Store it securely — we recommend using environment variables.
ROCKETSTACK_API_KEY=rs_live_xxxxxxxxxxxxMake Your First API Call
Let's store a value in KV to test your setup. Replace the API key with your own.
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"}}'{
"requestId": "...",
"data": { "key": "user-123", "version": "...", "expiresAt": null }
}That's it! You've successfully stored data in RocketStack. Explore the full API reference →
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.
MCP Integration
OptionalDeploy 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:
{
"mcpServers": {
"rocketstack": {
"command": "npx",
"args": ["-y", "@rocketstack/mcp-server"],
"env": {
"ROCKETSTACK_API_KEY": "rs_live_xxxx"
}
}
}
}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.