View as Markdown
Unthread icon

Unthread ACTION

Create Conversation

Create a new Conversation. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Unthread account once, then configure and run Create Conversation 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: "unthread-create-conversation",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    unthread: { authProvisionId: "apn_xxxxxxx" },
    type: "Type",
    markdown: "Markdown",
  },
})

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 Conversation inputs
Property Type Description
type Type string
Type of the conversation
Required
markdown Markdown string
Markdown of the conversation
Required
status Status string
Status of the conversation
Required
assignedToUserId Assigned To User ID string
ID of the User to whom the conversation is assigned
Optional Dynamic
customerId Customer ID string
ID of the Customer
Optional Dynamic
priority Priority integer
Priority of the conversation
Optional
triageChannelId Triage Channel ID string
ID the customer's Triage Channel. See the documentation for further information.
Required
notes Notes string
Notes of the conversation
Optional
title Title string
Title of the conversation
Optional
excludeAnalytics Exclude Analytics boolean
Exclude Analytics for this conversation
Optional
emailInboxId Email Inbox Id string
ID of the Email Inbox
Required
onBehalfOfEmail On Behalf Of Email string
Email on behalf of which the conversation is created
Optional
onBehalfOfName On Behalf Of Name string
Name on behalf of which the conversation is created
Optional
onBehalfOfId On Behalf Of ID string
ID on behalf of which the conversation is created
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
unthread-create-conversation
Version
0.0.2
App
Unthread
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes