View as Markdown
Xero Accounting icon

Xero Accounting ACTION

Create or update contact

Creates a new contact or updates a contact if a contact already exists. See the docs here
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Xero Accounting account once, then configure and run Create or update 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: "xero_accounting_api-create-update-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    xero_accounting_api: { authProvisionId: "apn_xxxxxxx" },
    tenantId: "Tenant ID",
    contactID: "Contact ID",
  },
})

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 or update contact inputs
Property Type Description
tenantId Tenant ID string
Select an organization tenant to use, or provide a tenant ID
Required Dynamic
contactID Contact ID string
ID of the contact that requires update.
Optional
name Contact name string
Full name of contact/organization.
Optional
firstName First name string
First name of contact person .
Optional
lastName Last name string
Last name of contact person.
Optional
emailAddress Email address string
Email address of contact person.
Optional
accountNumber Account number string
User defined account number..
Optional
contactStatus Contact status string
See https://developer.xero.com/documentation/api/accounting/types#contacts
Required

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
xero_accounting_api-create-update-contact
Version
0.1.2
App
Xero Accounting
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes