View as Markdown
Front icon

Front ACTION

Send New Message

Sends a new message from a channel. It will create a new conversation. See the documentation.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Front account once, then configure and run Send New Message 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: "frontapp-send-new-message",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    frontapp: { authProvisionId: "apn_xxxxxxx" },
    channelId: "Channel ID",
    authorId: "Author ID",
  },
})

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 New Message inputs
Property Type Description
channelId Channel ID string
Id or address of the channel from which to send the message
Required Dynamic
authorId Author ID string
ID of the teammate on behalf of whom the answer is sent
Required Dynamic
senderName Sender Name string
Name used for the sender info of the message
Optional
subject Subject string
Subject of the message for email message
Optional
body Body string
Body of the message. Accepts HTML
Required
text Text string
Text version of the body for messages with non-text body
Optional
attachments Attachments string[]
Provide either an array of file URLs or an array of paths to a files in the /tmp directory (for example, /tmp/myFile.pdf).
Optional
optionsTagIds Tag IDs string[]
List of tag names to add to the conversation (unknown tags will automatically be created)
Optional Dynamic
optionsIsArchive Is Archive boolean
Archive the conversation right when sending the message (Default: true)
Optional
to To string[]
List of recipient handles who received the message.
Required
cc CC string[]
List of recipient handles who received a copy of the message.
Optional
bcc BCC string[]
List of the recipeient handles who received a blind copy of the message.
Optional
syncDir SyncDir dir
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
frontapp-send-new-message
Version
0.2.12
App
Front
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes