Oct 13, 2020

API v1 Deprecation

As of today, API v1 is deprecated. In order to provide our customers the best possible features and a single, consistent REST API we will turn off API v1 on January 1, 2022. API v1 has been serving for nearly 8 years now and it is time to move forward.

API v2 was released for production use earlier this year. With the recent addition of the Get Metadata API, all features of API v1 are now available in API v2. API v2 uses a more robust design and better extensibility for new features. You can read more about the fundamentals of API v2 here.

What does this mean for our customers?

First of all, you want to build all new apps with API v2.

Second, you need to update your existing integrations to API v2. API v2 is using a completely different design, so please check out the API docs to get familiar with it. You have more than one year time to transition your app to API v2, which should be suifficient.

There are already official API v2 SDKs for PHP, node.js, Python and Java available. Ruby will follow soon. You might consider using them when upgrading your integration.

Timeline

  • May 27, 2019: Initial Beta release of API v2
  • January 7, 2020: Production-ready release of API v2
  • October 13, 2020: Deprecaton of API v1
  • June 2021: We will start to send out warning mails to remaining API v1 users
  • January 1, 2022: API v1 endpoints are turned off