View as Markdown
Xero Accounting icon

Xero Accounting ACTION

Create Bill

Creates a new bill (Accounts Payable)See the docs here
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

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

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 Bill inputs
Property Type Description
tenantId Tenant ID string
Select an organization tenant to use, or provide a tenant ID
Required Dynamic
invoiceNumber Invoice Number string
Unique alpha numeric code identifying invoice
Optional
reference Reference string
ACCREC only - additional reference number
Optional
contactId Contact ID string
Unique identification of the contact
Required Dynamic
lineItems Line Items string[]

The LineItems collection can contain any number of individual LineItem sub-elements. At least one is required to create a complete Invoice. Refer to Tax Type, Refer to Line Items

Example: [{"Description":"Football", "Quantity":"20", "UnitAmount":"50000", "TaxType":"OUTPUT" }]

Required
date Invoice Date string
Date invoice was issued - YYYY-MM-DD
Optional
dueDate Invoice Due Date string
Date invoice is due - YYYY-MM-DD
Optional
currencyCode The Invoice Currency string
The currency that invoice has been raised in. Refer to object documentation
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
xero_accounting_api-create-bill
Version
0.0.5
App
Xero Accounting
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes