How to sync your Timely customers to Xero

When the Xero integration is connected, we'll save you from having to enter your invoices in two separate places. As part of this process, we'll also make sure your customer information is synced to Xero. 

Customers will be synced to Xero when an invoice for them is created in Timely.


  • Customer: The customer or client, as they are in Timely.
  • Contact: The customer or supplier's details, as they are entered in Xero.
  • Xero ID: The ID of the contact in Xero. We use the Xero ID behind the scenes to match a customer in Timely to their contact in Xero.

A customer record in Timely will only have a Xero ID if the customer was imported from Xero (see below), or if an existing invoice for that customer has already been synced to Xero. 

Once a contact is created in Xero for a Timely customer, then any future invoices for this customer will be synced to the same contact. This is matched using their Xero ID.

When we create a contact in Xero, the following information from the customer's record will be included:

  • First name and last name.
  • Company name (If the customer has a Company name listed in Timely, this will be the Contact's name in Xero ).
  • Postal and physical address.
  • Email address.
  • Telephone number.
  • SMS number (Mobile).

If you have an existing customer database in Xero, then you can import your customers from Xero in to your Timely account. This applies a Xero ID to the customer in Timely, so whenever you raise an invoice for that customer in Timely it will be linked to their existing contact in Xero. 

When you import your customers from Xero, duplicate customer records may be created. You can merge a customer record and retain the Xero ID as long as the customer that originated from Xero is kept as the Primary Customer.  Check out our How to merge duplicate customers guide for more information.

How to import your Xero customers

There are two ways in which you can import customers into Timely:


From the Customers tab

  1. Head to the Customers tab in Timely.
  2. Click the Import customers button.
  3. Select Import from Xero from the list (this option will only be available once you are connected to Xero):

  4. Your customers from Xero will start importing.


From the Xero settings page

  1. Head to Setup > Add ons > Xero (Configure).
  2. Click the import customers button:

  3. Your customers will start importing.

How to sync a customer to an existing Xero contact

If you've been using both Timely and Xero separately and want to connect your Xero account to Timely, you may not want to import your contacts from Xero again.

A contact's name can only be used once in Xero, so it won't be possible to sync a new customer to Xero when a contact already exists for them. You will need to alter the name in Xero slightly so that they aren't recognised as the same contact. Once that's been done, you'll be able to sync the invoice to Xero and create a new contact.

It's then possible to merge the new contact with the existing contact, while retaining the link to the customer's record in Timely.

  1. Locate the existing Contact in Xero.
  2. Choose Options > Merge from the top right corner of their record.
  3. In the merge field, select the contact that was created by Timely: 

  4. Click Merge to confirm the process.

This will merge the sales history for the existing contact into the new contact. Any future invoices from Timely will then sync to the same merged contact.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Get in touch with the Support Team Get in touch with the Support Team