How To
Receiving Messages
What do we send to your API?
When you publish a message, QStash will deliver it to your chosen destination. This is a brief overview of how a request to your API looks like.
Headers
We are forwarding all headers that have been prefixed with Upstash-Forward- to your API. Learn more
In addition to your custom headers, we’re sending these headers as well:
| Header | Description |
|---|---|
User-Agent | Will be set to Upstash-QStash |
Content-Type | The original Content-Type header |
Upstash-Topic-Name | The topic name if sent to a topic |
Upstash-Signature | The signature you need to verify See here |
Upstash-Retried | How often the message has been retried so far. Starts with 0. |
Upstash-Message-Id | The message id of the message. |
Upstash-Schedule-Id | The schedule id of the message if it is related to a schedule. |
Upstash-Caller-IP | The IP address of the publisher of this message. |
Body
The body is passed as is, we do not modify it at all. If you send a JSON body, you will receive a JSON body. If you send a string, you will receive a string.