> ## Documentation Index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Publish
You can run the async code by importing `AsyncQStash` from `qstash`
and awaiting the methods.
#### Publish to a URL with a 3 second delay and headers/body
```python theme={"system"}
from qstash import QStash
client = QStash("")
res = client.message.publish_json(
url="https://my-api...",
body={
"hello": "world",
},
headers={
"test-header": "test-value",
},
delay="3s",
)
print(res.message_id)
```
#### Publish to a URL group with a 3 second delay and headers/body
You can make a URL group on the QStash console or using the [URL group API](/qstash/sdks/py/examples/url-groups)
```python theme={"system"}
from qstash import QStash
client = QStash("")
res = client.message.publish_json(
url_group="my-url-group",
body={
"hello": "world",
},
headers={
"test-header": "test-value",
},
delay="3s",
)
# When publishing to a URL group, the response is an array of messages for each URL in the group
print(res[0].message_id)
```
#### Publish a method with a callback URL
[Callbacks](/qstash/features/callbacks) are useful for long running functions. Here, QStash will return the response
of the publish request to the callback URL.
We also change the `method` to `GET` in this use case so QStash will make a `GET` request to the `url`. The default
is `POST`.
```python theme={"system"}
from qstash import QStash
client = QStash("")
client.message.publish_json(
url="https://my-api...",
body={
"hello": "world",
},
callback="https://my-callback...",
failure_callback="https://my-failure-callback...",
method="GET",
)
```
#### Configure the number of retries
The max number of retries is based on your [QStash plan](https://upstash.com/pricing/qstash)
```python theme={"system"}
from qstash import QStash
client = QStash("")
client.message.publish_json(
url="https://my-api...",
body={
"hello": "world",
},
retries=1,
)
```
By default, the delay between retries is calculated using an exponential backoff algorithm. You can customize this using the `retryDelay` parameter. Check out [the retries page to learn more about custom retry delay values](/qstash/features/retry#custom-retry-delay).
#### Publish HTML content instead of JSON
```python theme={"system"}
from qstash import QStash
client = QStash("")
client.message.publish(
url="https://my-api...",
body="Hello World
",
content_type="text/html",
)
```
#### Publish a message with [content-based-deduplication](/qstash/features/deduplication)
```python theme={"system"}
from qstash import QStash
client = QStash("")
client.message.publish_json(
url="https://my-api...",
body={
"hello": "world",
},
content_based_deduplication=True,
)
```
#### Publish a message with timeout
Timeout value to use when calling a url ([See `Upstash-Timeout` in Publish Message page](/qstash/api-reference/messages/publish-a-message))
```python theme={"system"}
from qstash import QStash
client = QStash("")
client.message.publish_json(
url="https://my-api...",
body={
"hello": "world",
},
timeout="30s",
)
```