View as Markdown
ServiceM8 icon

ServiceM8 ACTION

Create Job Material

Create a job material line. 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 Job Material 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-job-material",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    servicem8: { authProvisionId: "apn_xxxxxxx" },
    jobUuid: "Job",
    materialUuid: "Material (catalog)",
  },
})

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 Job Material inputs
Property Type Description
jobUuid Job string
The UUID of the job this material is associated with. Required; links the line to its parent job.
Required Dynamic
materialUuid Material (catalog) string
The UUID of the material catalog item this job material is based on.
Optional Dynamic
name Name string
Name shown on invoices (max 500 characters). Often from the catalog material; can be customized per job.
Optional
quantity Quantity string
Quantity for this line (required; cannot be empty; max 100 characters).
Required
price Price string
Unit price excluding tax. The system may adjust for tax-inclusive pricing consistency.
Optional
displayedAmount Displayed amount string
Unit price as shown on invoices/quotes (required; tax-inclusive or exclusive per “Displayed amount is tax inclusive”).
Required
displayedAmountIsTaxInclusive Displayed amount is tax inclusive boolean
Whether the displayed amount includes tax (displayed_amount_is_tax_inclusive).
Required
taxRateUuid Tax rate string
The UUID of the tax rate for this line item.
Optional Dynamic
sortOrder Sort order string
Display order on the job (lower values first).
Optional
cost Cost string
Material cost for this job (ex-tax amount).
Optional
displayedCost Displayed cost string
Cost as displayed (required; inc-tax or ex-tax depending on displayed_amount_is_tax_inclusive).
Required
uuid Record UUID string
Optional unique identifier for this record if the API allows you to supply one; otherwise leave blank.
Optional
jobMaterialBundleUuid Job material bundle UUID string
JobMaterialBundle UUID if this line belongs to a bundle. Leave blank if not part of a bundle.
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-create-job-material
Version
0.0.2
App
ServiceM8
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes