View as Markdown
ServiceM8 icon

ServiceM8 ACTION

Create Staff Member

Create a staff member. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's ServiceM8 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: "servicem8-create-staff",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    servicem8: { authProvisionId: "apn_xxxxxxx" },
    first: "First Name",
    last: "Last 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
first First Name string
First name (max 30 characters).
Required
last Last Name string
Last name (max 30 characters).
Required
email Email string
Email address; also used as login name.
Required
mobile Mobile string
Mobile number for SMS and caller identification.
Optional
jobTitle Job Title string
Role or title shown across the product.
Optional
navigatingToJobUuid Navigating to job string
Job the staff member is currently navigating to (navigating_to_job_uuid).
Optional Dynamic
color Color string
Hex color for schedule and dispatch display (color).
Optional
statusMessage Status message string
Short summary of current status (status_message).
Optional
statusMessageTimestamp Status message timestamp string
When the status message was last updated (status_message_timestamp; e.g. YYYY-MM-DD HH:MM:SS).
Optional
hideFromSchedule Hide from schedule boolean
Enable to hide this staff member from the schedule (hide_from_schedule).
Optional
securityRoleUuid Security Role string
Permission set (API security_role_uuid).
Optional Dynamic
labourMaterialUuid Labour Material string
Default labour inventory material (API labour_material_uuid).
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
servicem8-create-staff
Version
0.0.1
App
ServiceM8
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes