View as Markdown
Front icon

Front ACTION

Create Draft

Create a draft message which is the first message of 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 Create Draft 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-create-draft",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    frontapp: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team ID",
    channelId: "Channel 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.

Create Draft inputs
Property Type Description
teamId Team ID string
ID of a team
Required Dynamic
channelId Channel ID string
Id or address of the channel from which to send the message
Required Dynamic
body Body string
Body of the draft message. Accepts HTML
Required
subject Subject string
Subject of the draft
Optional
authorId Author ID string
ID of the contact in Front corresponding to the sender
Required Dynamic
to To string[]
List of recipient handles who received the message.
Optional
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
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
mode Mode string
Mode of the draft to create. Can be 'private' (draft is visible to the author only) or 'shared' (draft is visible to all teammates with access to the conversation).
Optional
signatureId Signature ID string
ID of the signature to attach. If ommited, no signature is attached.
Optional Dynamic
shouldAddDefaultSignature Should Add Default Signature boolean
Whether or not Front should try to resolve a signature for the message. Is ignored if signature_id is included. Default false
Optional
quoteBody Quote Body string
Body for the quote that the message is referencing. Only available on email channels.
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-create-draft
Version
0.0.7
App
Front
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes