View as Markdown
ServiceM8 icon

ServiceM8 ACTION

Update Company Contact

Update a company contact (loads the record, merges your fields, then POSTs). See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's ServiceM8 account once, then configure and run Update Company Contact 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-update-company-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    servicem8: { authProvisionId: "apn_xxxxxxx" },
    uuid: "Company contact to update",
    companyUuid: "Company",
  },
})

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.

Update Company Contact inputs
Property Type Description
uuid Company contact to update string
Company contact record to load, merge, and save (search or paste UUID).
Required Dynamic
companyUuid Company string
The UUID of the company this contact belongs to
Optional Dynamic
first First Name string
First name of the company contact; used to identify and address the contact
Optional
last Last Name string
Last name; used together with first name to identify the contact
Optional
phone Phone string
Primary phone number (include area code; international prefix allowed)
Optional
mobile Mobile string
Mobile number for SMS and voice; include area code and international prefix if needed
Optional
email Email string
Email for quotes, invoices, and other correspondence
Optional
type Type string
Contact type (type in the API): BILLING, JOB, or Property Manager.
Optional
isPrimaryContact Primary Contact boolean
Whether this is the primary company contact (is_primary_contact). Only one active primary contact per company.
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
servicem8-update-company-contact
Version
0.0.2
App
ServiceM8
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes