State of Embedded Finance 2026: Take the 5-minute survey and help shape the report. Participate →

Contacts

Xero Contacts API

Sync permissioned contacts data with Xero through Apideck's unified API. One integration, instant access to the governed data your team needs.

Get started for free View Customers API

In Apideck, this resource is called Customers (API: customers)

Supported Operations for Xero Contacts

Full CRUD support available through our unified API

list

get

create

update

delete

Supported Fields

14 fields

Fields available for Xero Contacts

iddisplay_namecompany_namefirst_namelast_nameaddressesphone_numbersemailswebsitesbank_accountstax_numbercurrencystatusupdated_at

API Model Preview

Sample response structure for contacts

{
  "id": "12345",
  "display_name": "Example Display Name",
  "company_name": "Example Company Name",
  "first_name": "Example First Name",
  "last_name": "Example Last Name",
  "addresses": [
    {
      "id": "123",
      "type": "primary",
      "string": "25 Spring Street, Blackburn, VIC 3130",
      "name": "HQ US",
      "line1": "25 Spring Street",
      "line2": "Suite 100",
      "city": "Blackburn",
      "state": "VIC",
      "postal_code": "3130",
      "country": "US"
    }
  ],
  
  ...

Quick Start Example

Start syncing Xero contacts in minutes

Node.js

import { Apideck } from '@apideck/unify'

const apideck = new Apideck({
  apiKey: process.env.APIDECK_API_KEY,
  appId: 'YOUR_APP_ID',
  consumerId: 'YOUR_CONSUMER_ID'
})

// List contacts from Xero
const result = await apideck.accounting.customers.list({
  serviceId: 'xero'
})

for await (const page of result) {
  console.log(page)
}
// Returns unified contacts data

View full SDK documentation

Related Data Models

Other Xero Data You Can Sync

Explore more Xeroresources available through Apideck's unified API

Organisations

Connections

Tax Rates

Accounts

Items

Invoices

Payments

Bill Payments

View all 23 Xero resources

Popular Use Cases

How Contacts is Commonly Used

Discover the most popular ways businesses integrate Xero contacts data

Accounts Receivable

Push invoices, payment statuses & credits into users' ledgers.

Learn more

Debt Collections

Automate collections workflows with real-time visibility into outstanding invoices, aged receivables, and payment status.

Learn more

Explore all use cases

Other connectors with Contacts support

We build and maintain connectors, so you don't have to. View our full list of Accounting connectors.
Missing a connector? We're able to add new connectors.