Primitives Queue
Queue API
Deliver payloads to any endpoint with automatic retries. No queues to provision, no infrastructure to scale.
Quickstart
Enqueue a message and have it delivered to your webhook in seconds.
1. Enqueue a message
Push a payload with your target webhook URL.
POST https://api.rocketstack.dev/queues
{
"name": "orders",
"deliveryTarget": {
"type": "webhook",
"webhookUrl": "https://yourapp.com/webhook"
}
}
# Then enqueue:
POST https://api.rocketstack.dev/queues/{queueId}/messages
{ "payload": { "event": "order.created", "id": "ord_123" } }2. Get message ID
Each message gets a unique UUID for tracking.
// Response from create queue (201):
{ "data": { "queueId": "qu_abc123", "status": "..." } }
// Response from enqueue (201):
{ "data": { "messageId": "msg_xyz", "status": "..." } }3. Receive delivery
Your webhook receives the payload with automatic retries on failure.
// When a message is delivered, your webhook receives:
POST https://yourapp.com/webhook
{ "payload": { "event": "order.created", "id": "ord_123" } }Features
Everything you need for reliable message delivery.
UUID per message
Every message gets a unique identifier for tracking and deduplication.
Webhook delivery
Point to your endpoint — we deliver when ready. Any URL that accepts POST.
JSON payloads
Send and receive structured data. We preserve your payload exactly as sent.
Automatic retries
Failed deliveries retry with exponential backoff. Never lose a message.
Limits & Quotas
Generous defaults for most workloads.
| Resource | Limit |
|---|---|
| Message payload size | 1 MB |
| Retry attempts | 5 (with exponential backoff) |
| Message TTL | 7 days |
| Concurrent deliveries | 100 per webhook URL |
| Webhook timeout | 30 seconds |
Use Cases
Use the queue when you need to decouple sender and receiver and get automatic retries.
Webhook processing
Receive webhooks from Stripe, GitHub, or any service. Acknowledge immediately, process reliably via queue.
Async job dispatch
Offload heavy work from your API. Enqueue jobs for background processing without blocking requests.
Event distribution
Fan out events to multiple services. Each subscriber gets reliable delivery with retries.
Ready to queue your first message?
Get your API key and start delivering payloads reliably.