View as Markdown
Discord icon

Discord ACTION

Send Message (Advanced)

Send a simple or structured message (using embeds) to a Discord channel
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Discord account once, then configure and run Send Message (Advanced) from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "discord-send-message-advanced",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    discord: { authProvisionId: "apn_xxxxxxx" },
    channel: "Channel",
    message: "Message",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Send Message (Advanced) inputs
Property Type Description
channel Channel $.discord.channel
Required
message Message string
Enter a simple message up to 2000 characters. This is the most commonly used field. However, it's optional if you pass embed content.
Optional
threadID Thread ID string
If provided, the message will be posted to this thread
Optional
username Username string
Overrides the current username of the webhook
Optional
avatarURL Avatar URL string
If used, it overrides the default avatar of the webhook. Note: Consecutive posts by the same username within 10 minutes of each other will not display updated avatar.
Optional
includeSentViaPipedream Include link to workflow boolean
Defaults to true, includes a link to this workflow at the end of your Discord message.
Optional
suppressNotifications Suppress notifications boolean
Defaults to false, sends the message as silent, triggers no notifications to clients.
Optional
embeds Embeds any
Optionally pass an array of embed objects. E.g., {{ [{"description":"Use markdown including *Italic* **bold** __underline__ ~~strikeout~~ [hyperlink](https://google.com) `code`"}] }}. To pass data from another step, enter a reference using double curly brackets (e.g., {{steps.mydata.$return_value}}). Tip: Construct the embeds array in a Node.js code step, return it, and then pass the return value to this step.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
discord-send-message-advanced
Version
1.0.3
App
Discord
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes