View as Markdown
Microsoft Bookings icon

Microsoft Bookings ACTION

Create Staff Member

Creates a new staff member in a Microsoft Bookings business. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Bookings account once, then configure and run Create Staff Member 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_bookings-create-staff-member",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_bookings: { authProvisionId: "apn_xxxxxxx" },
    businessId: "Business",
    displayName: "Display Name",
  },
})

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 Staff Member inputs
Property Type Description
businessId Business string
Select a booking business
Required Dynamic
displayName Display Name string
The name of the staff member, as displayed to customers
Required
emailAddress Email Address string
The email address of the staff member
Required
role Role string
The role of the staff member in the business
Required
timeZone Time Zone string
The time zone of the staff member (e.g., America/Chicago)
Optional
useBusinessHours Use Business Hours boolean
True means the staff member's availability is as specified in the businessHours property of the business. False means the availability is determined by the staff member's workingHours property setting
Optional
isEmailNotificationEnabled Email Notifications Enabled boolean
Whether to send email notifications to the staff member
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
microsoft_bookings-create-staff-member
Version
0.0.1
App
Microsoft Bookings
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes