# Queues (/sdks/python/reference/queues)



Send messages with `send_queue_message`, receive them through `receive_queue_messages`, and extend flows with streaming helpers (see SDK examples for stream send/receive patterns).

## Simple Queues [#simple-queues]

### send\_queue\_message [#send_queue_message]

```python
await client.send_queue_message(message: QueueMessage) -> QueueSendResult
```

**QueueMessage fields:**

| Field                   | Type             | Required    | Description   |
| ----------------------- | ---------------- | ----------- | ------------- |
| `channel`               | `str`            | Yes         | Queue channel |
| `body`                  | `bytes`          | Conditional | Payload       |
| `metadata`              | `str`            | Conditional | Metadata      |
| `tags`                  | `dict[str, str]` | No          | Routing tags  |
| `delay_in_seconds`      | `int`            | No          | Initial delay |
| `expiration_in_seconds` | `int`            | No          | TTL           |
| `max_receive_count`     | `int`            | No          | Retry budget  |
| `max_receive_queue`     | `str`            | No          | DLQ channel   |

### receive\_queue\_messages [#receive_queue_messages]

```python
await client.receive_queue_messages(
    channel: str,
    max_messages: int,
    wait_timeout_seconds: int,
    auto_ack: bool = False,
) -> QueuesPollResponse
```

Polls for messages with optional visibility and auto-ack semantics.

## Queue Streaming [#queue-streaming]

Streaming queue APIs (send/receive streams, ack ranges, nack/requeue) follow the same semantics as other SDKs but are exposed through Python-specific helpers. Refer to the [Queues examples](/sdks/python/how-to/queues/) for the exact async methods available in your SDK version.

## Quick Usage [#quick-usage]

```python title="queues.py"
msg = QueueMessage(channel="jobs", body=b"task")
await client.send_queue_message(msg)
```

## See Also [#see-also]

* [Queues Examples](/sdks/python/how-to/queues/)
* [Queues pattern](/learn/queues/getting-started)
* [Python SDK Getting Started](/sdks/python)