Xero Accounting API

Welcome to our official feedback forum for the Xero Developer API.

The Xero Community site is the best place to submit feedback for improving Xero Business

I suggest you ...

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the "My feedback" filter and select "My open ideas".
(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  • Hot ideas
  • Top ideas
  • New ideas
  • My feedback
  1. add custom fields to contacts

    Ability to create or edit additional 'custom' fields to use for notes, additional phone numbers, job descriptions, etc.

    146 votes
    Vote
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      You have left! (?) (thinking…)
      22 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
    • EU Country field

      Be able to update the EU Country field via the API. This is required and seems very strange to be left out of the API.

      129 votes
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)
        You have left! (?) (thinking…)
        4 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
      • when contacts are merged show this status for the API

        When merging contacts the system seems to treat them as a delete so we can’t differentiate them from a full delete. Ideally they should show a status of merged and the ID of the contact they were merged with that way we could perform the same action in the CRM of merging the contacts history rather than deleting them.

        95 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)
          You have left! (?) (thinking…)
          7 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
        • Allow add multiple Contacts with same name.

          It should be different crietaia to add contacts. It should allow contacts with same name , may be have different personal details. validation should not be on name.

          86 votes
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)
            You have left! (?) (thinking…)
            4 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →

            We’re currently investigating the feasibility of making this change. There are quite a few complications (for the API as well as our other apps) because you won’t be able to use contact name as an identifier anymore but we’ll planning on making the transition as smooth as possible.

          • 71 votes
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)
              You have left! (?) (thinking…)
              10 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
            • Merge contacts via the API

              Provide the ability to merge contacts via the API.

              48 votes
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)
                You have left! (?) (thinking…)
                1 comment  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
              • provide API access to contact Statements!

                I would like to get a contact's statement via API just like the case is for invoices.In the request, we provide contact name then the response is the statement of the contact.This will be a cool feature to have.

                33 votes
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                  2 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                • update archived contacts

                  Being able to update or unarchive contacts via the api

                  24 votes
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                    2 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                  • use consistent response structures

                    The addition of reporting a contact's balances was a great addition, however I feel the response structure should be consistent, regardless of balances. Where any balances are $0, this should be reported as $0, instead of being removed. By removing the key, we are left only being able to test for the absence of data, which creates an assumptive logic.

                    I understand that removing keys for null values might be part of your api design (ie no email address entered doesn't return an empty <EmailAddress>, but technically, a customer always has a balance so there for the Balances data should…

                    21 votes
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                      0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                    • Enable multiple shipping addresses for a contact

                      Please can we allow a contact to be associated with multiple shipping addresses. Whilst groups work to some extent, it is unforgiving if there are any inaccuracies in group membership (which does occur).

                      15 votes
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                        0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                      • Get address lable for my organization

                        When I create new delivery address for new PO I am able to specify its lable. However when I try to obtain available addresses from my company settings I cannot find address lable only address type. For all delivery addresses this type is the same: DELIVERY.

                        We would like to list company addresses the way it is done during Purchase Order creation in Xero. The problem is that API does not send back the "Label" of the addresses (bold text like "Postal" or "Physical"). These labels are very important since they are used to set some meaningful name to the…

                        12 votes
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                          0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                        • Make the BrandingTheme for a contact customizable

                          Currently the field 'BrandingTheme' is only returned on a GET request. We would like to have this field customizable, so we can change the theme used based on info in our CRM

                          12 votes
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                            0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                          • Include contacts that have been converted to customers (or suppliers) when "If-Modified-Since" filter is applied

                            When a contact is created in Xero it is not until after an invoice has been created that it gets converted to a customer (or supplier). Which is expected.

                            However when the "If-Modified-Since" filter is used on the GET Contacts endpoint where the "If-Modified-Since" date is after the contact is created but before the conatct as made into a supplier (i.e. after the isCustomer or isSuppler flag flips from false to true in the body of the Contact response) then the contact is not returned in the response.

                            I sugget a change that when a contact is converted to a…

                            12 votes
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                              1 comment  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                            • Allow the full UTF8 character set in Contact Names

                              Names containing accented characters, eg: Nuñez, are rejected when uploading a new Contact.

                              11 votes
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                                1 comment  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                              • Smart lists via API

                                Expose the new smart lists feature via the API (more info here: https://www.xero.com/tv/video/?id=5986-smart-lists-in-xero)

                                10 votes
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                  2 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                • contact notes

                                  Access to the Notes field in the Contacts endpoint would be nice.

                                  9 votes
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                    0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Expose whether invoice reminders are enabled for a particular contact

                                    This request is to expose a boolean value to determine whether invoice reminders are enabled for a particular contact.

                                    Please let us know in the comments if you'd like to update this value as well as retrieve it.

                                    7 votes
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                      0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Contacts' creation date exposed in API

                                      Would enable the measurement of new business. e.g. number of new customers since the start of the year and their $ value.

                                      6 votes
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                        0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                      • TaxNumber type field

                                        Contact entity has a field to store Tax number type (EIN, SSN, ITIN and ATIN). This field is accessible via UI or in exported csv file, but not accessible via API, while "Tax Number" itself can be read using API.

                                        5 votes
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                          0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                        • be able to enter customers address when you create a quote/invoice.

                                          I'd like to be to able to enter the customers address when I create a quote or invoice. Currently I can only do this once the quote/invoice is created by editing the customers details.

                                          3 votes
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                            0 comments  ·  Contacts  ·  Flag idea as inappropriate…  ·  Admin →
                                          ← Previous 1
                                          • Don't see your idea?

                                          Feedback and Knowledge Base