20.11.2026, 07:43

Important: integrations with the User API will stop working as of January 1, 2027

We are disabling the User API — the old FoodSoul API that was previously used to change order statuses, update prices and delivery areas, and manage couriers. It has not been updated for a long time: all new features are now added to the CRM API. 
 

If your integration works through the User API, you need to switch it to the CRM API by January 1. Otherwise, after this date, FoodSoul will return an error to all its requests. Below, we explain how to prepare for the transition.
 

How to check your integration
 

Your developer can check whether your integration uses the User API. Such an integration sends requests to addresses like:

  • https://foodsoul.ru/api/user/v1/ (as well as by.) — first version;
  • https://foodsoul.ru/api/user/v2/ (as well as by.) — second version.

If you are unsure, ask the person who maintains your integration or contact support.
 

Benefits of switching
 

The CRM API is much more capable than the User API: it allows you to work with orders and their cards, menus, stop lists and stock, customers, promotions, and reports.
 

Webhooks deserve special mention. With them, the CRM itself notifies your system about events — for example, a new order or a status change — so your integration does not need to constantly poll the API.
 

Another advantage is separate access tokens. Each integration can be issued its own token with the necessary permissions, and you can block or delete it at any time if needed.
 

How to switch

  1. Create an API token in the CRM: “Integrations” → “API Access Tokens”. Save it immediately: the token is shown only once, at creation.
  2. Give the token and the link to the CRM API documentation to your developer.
  3. The developer will migrate the integration to the CRM API. Simply changing the address is not enough: the action is now specified in the request URL, and the list of fields sent in requests and responses has changed.
     

Please remember to do this by January 1, 2027.
 

The full CRM API documentation is available on the FoodSoul portal: docs.foodsoul.ru. If you need help with the transition, please contact support.



Best regards, the FoodSoul team! We work for you!