Post a Discord announcement
post_to_discordPublish messages, announcements, embeds, polls, and files to a Discord server channel, using the Hermoso bot or a webhook and returning the message ID for edits and replies.
Instructions
Post to the user's Discord server. Free. With the Hermoso bot added it posts as the bot to channel (or the brand's default channel) with attachments up to 25 MB a message, replyTo, threadId (inside a thread), startThread (a thread under the post) and threadName (a forum channel); the messageId it returns ("/") is what edit, delete and get_discord_message take. Without the bot it posts through the brand's announcement webhook (never the alert one): ≤2000 characters, files up to 20 MB attached (up to 10), larger ones as links. Mentions never ping unless mentions:true. EITHER WAY it can carry embeds (up to 10 rich cards, 6000 characters between them), a native poll (question, up to 10 answers, 1 to 768 hours; get_discord_poll reads the votes) and tts (read aloud). A webhook post can also take a display name and avatar for that one post (username, avatarUrl); crosspost:true (bot only) also publishes the post to every server that follows the announcement channel. Anything over a Discord limit is refused, never cut. Reactions are the only per-post number (get_discord_message). Not connected: connect_connector with provider discord and no fields returns the install link.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "post_to_discord"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tts | No | a text-to-speech message, read aloud to people who have the channel open | |
| hook | No | the post's angle — a list_hooks id or your own wording, reused exactly | |
| poll | No | a native poll: { question (300), answers: ["..", { text (55), emoji }] (up to 10), durationHours (1-768, default 24), multiselect }. A poll cannot be edited after posting | |
| text | No | the announcement, ≤2000 characters | |
| brand | No | WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted. | |
| embeds | No | up to 10 embeds: { title (256), description (4096), url, color ("#5865F2" or a number), fields: [{ name (256), value (1024), inline }] (25), author: { name (256), url, iconUrl }, footer: { text (2048), iconUrl }, image, thumbnail (links), timestamp (ISO or "now") } | |
| ideaId | No | short id of the content-plan idea this post came from | |
| recipe | No | the post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format | |
| silent | No | post without a notification | |
| channel | No | HERMOSO BOT: channel id or #name (list_discord_channels); unset = the default channel | |
| replyTo | No | HERMOSO BOT: reply to this message id | |
| subject | No | what the post is about | |
| imageUrl | No | ||
| mentions | No | let @everyone / @here / role mentions ping people (off by default) | |
| threadId | No | HERMOSO BOT: post inside this existing thread | |
| username | No | webhook posts only: a different display name than the webhook's own | |
| videoUrl | No | ||
| avatarUrl | No | webhook posts only: an avatar image link for this one post | |
| crosspost | No | HERMOSO BOT, announcement channels: also publish it to every server that follows the channel (cannot be undone) | |
| imageUrls | No | up to 10 files in one message | |
| threadName | No | required when the channel is a FORUM channel: the new thread title | |
| startThread | No | HERMOSO BOT: start a thread under the new post with this title | |
| discordServer | No | HERMOSO BOT: which Discord server (id or name) when the bot is in several | |
| allowDuplicate | No | post it even though an identical post was just made | |
| idempotencyKey | No | any stable string: a repeat within 24h returns the original post instead of posting again |