Customers won't be accessible anymore via the /users endpoints on October 25, 2022

We've decided to postpone the initial date of the API breaking change we were supposed to apply on August 1, 2022 regarding the Users API endpoints: Customers won't be accessible anymore via the /users endpoints on 2022-08-01.
The new release date is Oct 25, 2022. Before this date, we will perform a series of brownouts in an attempt to warn third-party developers who still haven't migrated their apps about this upcoming breaking change.


  • October 11, 2022, from 4:00 PST to 16:00 PST (12 hours)
  • October 13, 2022, from 00:00 PST to 23:59 PST (24 hours)
  • October 18, 2022 00:00 PST to October 19, 2022 23:59 PST (48 hours)


Starting from October 25, 2022:

  • The /users endpoints won't work to create, list, retrieve, update and delete customers. Instead, you will have to use the /customers endpoints. The /users endpoints will only be used to manage Gorgias users (people using Gorgias).
  • The "create user" and "update user" endpoints won't accept the channels, customer, data, and roles attributes in the payload. Sending one of these attributes will result in an HTTP 400 - Bad request error.

Migration guide:

Review HTTP requests you send to the /users endpoints:

  • If you are calling these endpoints to create, list, retrieve, update, delete Users:
    • When creating or updating users:
      • remove body parameters channels, customer, and data
      • replace usage of roles with role
    • Remove usage of the deprecated attributes returned in the responses that are not User's attributes (channels, customer, data, integrations, and roles).
  • If you call this endpoint to create, list, retrieve, update, delete Customers:
    • Replace the /users part in the URL of your HTTP request with /customers.