Send Message
reddit.send_message
ActionChat & messagingconnection required
Calls the Reddit API with the connection's credentials.
Send a private message to a redditor, or modmail from a subreddit.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Secret shape
- {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
- Config it needs
- user_agent, subreddit
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 3 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
to Recipient: a username, or 'r/subreddit' to write to its moderators. | string | Yes | — | — | spez |
subject Subject line of the message. | string | Yes | — | ≤ 100 characters | — |
text Markdown body of the message. | string | Yes | — | — | — |
from_subreddit Send as the moderators of this subreddit instead of as yourself. The account needs the subreddit's 'mail' moderator permission. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"to": "spez"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
sent True once Reddit accepted the message. | boolean | — |
to The recipient the message was addressed to. | string | — |
errors Reddit's api_type=json error rows, each with a code, message and field. Empty when Reddit accepted the write without complaint. | array | — |
{
"errors": [],
"sent": false,
"to": ""
}See Send Message run in a workflow.
In a technical demo we add the Reddit connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.