---
title: "ezgh queues send"
description: "Send a message to a queue."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh queues send

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh queues send <queue> [--body text | --file path | stdin] [--attr k=v…] [--group g] [--dedup d] [--delay t] [flags]
```

Send one message: its body is `--body`, the contents of `--file`, or what's piped on stdin (UTF-8 text; with its attributes, at most 256 KiB). `--attr` adds an attribute (up to 10; keys don't start with ezgh.).

A FIFO queue needs `--group`, the message group it's delivered in order within, and `--dedup` unless the queue deduplicates by content: a send with a dedup ID seen in the last 5 minutes isn't stored again, and answers the original message's ID. `--delay` (standard queues only, up to 15m) holds the message back before its first delivery, in place of the queue's delay.

Part of [`ezgh queues`](/cli/reference/queues).

## Examples

```sh
ezgh queues send orders --body '{"orderId": 42}' --attr source=checkout
cat order.json | ezgh queues send orders
ezgh queues send payments --file payment.json --group acct-9 --dedup pay-1842
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--attr` | string, repeatable |  | an attribute, key=value (repeat) |
| `--body` | string |  | the message's body |
| `--dedup` | string |  | FIFO: the deduplication ID |
| `--delay` | string |  | standard queues: hold the message back this long (0 to 15m) |
| `--file` | string |  | read the body from this file |
| `--group` | string |  | FIFO: the message group |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/queues-send/index.mdx