View as Markdown
Microsoft Dynamics 365 Sales icon

Microsoft Dynamics 365 Sales ACTION

Create Appointment

Create a new appointment linked to an account with a required attendee (system user). Use List Appointment Categories for valid category values. See the documentation and the appointment entity reference
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Dynamics 365 Sales account once, then configure and run Create Appointment 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: "microsoft_dynamics_365_sales-create-appointment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_dynamics_365_sales: { authProvisionId: "apn_xxxxxxx" },
    subject: "Subject",
    scheduledstart: "Scheduled Start",
  },
})

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 Appointment inputs
Property Type Description
subject Subject string
Title of the appointment (for example 1st Meeting with {Prospect Name})
Required
scheduledstart Scheduled Start string
Start in ISO 8601 (for example 2026-02-20T12:00:00Z)
Required
scheduledend Scheduled End string
End in ISO 8601, typically one hour after start
Required
regardingAccountId Regarding Account string
Account the appointment is regarding
Required Dynamic
requiredAttendeeEmail Required Attendee Email string
Internal email address of the Dynamics system user (salesperson) to add as attendee
Required
category Category of appointment integer
Optional Category of Appointment (numeric option). Omit to let Dynamics use its default for your org
Optional Dynamic

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
microsoft_dynamics_365_sales-create-appointment
Version
0.0.3
App
Microsoft Dynamics 365 Sales
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes