upstash-qstash-js

✓ Official★ 12

by upstash · part of upstash/skills

Work with the QStash TypeScript/JavaScript SDK for serverless messaging, scheduling. Use when publishing messages to HTTP endpoints, creating schedules,…

🔥🔥🔥✓ VerifiedFreeQuick setup

#automation #calendar #cloud #git

🧩 One of 7 skills in the upstash/skills package — works on its own, and pairs well with its siblings.

Work with the QStash TypeScript/JavaScript SDK for serverless messaging, scheduling. Use when publishing messages to HTTP endpoints, creating schedules,…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by upstash

Work with the QStash TypeScript/JavaScript SDK for serverless messaging, scheduling. Use when publishing messages to HTTP endpoints, creating schedules,… npx skills add https://github.com/upstash/skills --skill upstash-qstash-js Download ZIP GitHub12

QStash JavaScript SDK

QStash is an HTTP-based messaging and scheduling solution for serverless and edge runtimes. This skill helps you use the QStash JS SDK effectively.

When to use this skill

Use this skill when:

Publishing HTTP messages to endpoints or URL groups
Creating scheduled or delayed message delivery
Managing FIFO queues with configurable parallelism
Verifying incoming webhook signatures from QStash
Implementing callbacks, DLQ handling, or message deduplication

Core Concepts

For fundamental QStash operations, see:

Publishing Messages
Schedules
Queues and Flow Control
URL Groups
Local Development — automatic dev server via devMode: true

For verifying incoming messages:

Receiver Verification - Core signature verification with the Receiver class
Platform-Specific Verifiers:
Next.js - App Router, Pages Router, and Edge Runtime

For advanced features:

Callbacks
Dead Letter Queue (DLQ)
Message Deduplication
Region migration & multi-region support
If needed, multi-region env variable setup verification script. Can be run without arguments

Platform Support

QStash JS SDK works across various platforms:

Next.js (App Router and Pages Router)
Cloudflare Workers
Deno
Node.js (v18+)
Vercel Edge Runtime
SvelteKit, Nuxt, SolidJS, and other frameworks

Note on Workflow SDK: For building complex durable workflows that chain multiple QStash messages together, consider using the separate QStash Workflow SDK (@upstash/workflow). The Workflow SDK empowers you to orchestrate multi-step processes with automatic state management, retries, and fault tolerance. This Skills file focuses on the core QStash messaging SDK.

Best Practices

Always verify incoming QStash messages using the Receiver class
Use environment variables for tokens and signing keys
Set appropriate retry counts and timeouts for your use case
Use queues for ordered processing with controlled parallelism
Implement DLQ handling for failed message recovery

Copy & paste — that's it

npm install @upstash/qstash

Run this in your project — your agent picks the skill up automatically.

Quick Start

Installing the SDK

Copy & paste — that's it

npm install @upstash/qstash

Basic Publishing

Copy & paste — that's it

import { Client } from "@upstash/qstash";

const client = new Client({
 token: process.env.QSTASH_TOKEN!,
});

const result = await client.publishJSON({
 url: "https://my-api.example.com/webhook",
 body: { event: "user.created", userId: "123" },
});