Getting Started with Wolt
Prerequisites
- A Wolt integration for your venue. Wolt sets this up together with you, so you need a Wolt contact before you start.
- A Wolt account that can sign in to that integration.
- Only for the Custom OAuth 2.0 method: the Client Id and Client Secret of your own Wolt integration app, which you get from Wolt.
How to get access
The Wolt integration is set up by Wolt, not in Engini. Wolt’s developer documentation is at developer.wolt.com.- Contact Wolt and ask to start an integration. Wolt’s integration partners page has a “Become Wolt’s integrator” link for this. If you already work with a Wolt account manager or technical account manager, ask them.
- Wolt sends you its requirements and terms, and issues test credentials once it has everything it needs.
- Build and test your workflows against a Sandbox venue. Sandbox is Wolt’s safe test environment, and it has limits, such as no real couriers.
- When you are ready, Wolt launches the integration at a pilot venue in Production, the live environment.
What to ask your Wolt contact
- Set up the Wolt integration for my venue, in Sandbox, Production or both.
- Enable OAuth 2 sign-in for my Wolt account.
- Custom OAuth 2.0 only: the Client Id and Client Secret of my integration app, with the redirect URI and the
offlinescope registered for it. - Order notifications only: send them to
https://webhooks.engini.io/Wolt/v1.
Add a connection to Wolt in Engini
- Enter your Engini account at https://app.engini.io.
-
Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.

-
Click on the “New Integration” option located at the top bar.

-
Choose the Wolt option from the available applications.

- Enter the following details in the “New Integration” form and press Save:
OAuth 2
This is the default method. It uses a predefined authentication flow, so you don’t need to provide a Client Id or Client Secret: you simply sign in to Wolt. Before you create the connection, ask Wolt to enable the integration for your venue, and tell them whether you work with Sandbox, Production or both. You don’t get or copy any keys: in Engini you sign in with your Wolt account and approve the access request.
- Connection Name - Enter a name that helps identify the Wolt connection.
- Authentication Method - Select OAuth 2.
- Environment - Choose the Wolt environment the connection works with. The default is Production.
- Production - The live Wolt environment, where real orders and venues are handled.
- Sandbox - Wolt’s isolated test environment, where you can build and test your workflows without real-world consequences.
- Api Url - Filled in automatically from the Environment you chose. It can’t be edited.
- Venue Id - Filled in automatically after you sign in, from your Wolt sign-in. It can’t be edited.
- Signin - Click Signin, sign in to Wolt and approve the access request. Use the Wolt account that was set up for your integration.
- Save - Click Save to create the connection.
Custom OAuth 2.0
This method uses your own Wolt integration app. You must provide its Client Id and Client Secret, which Wolt gives you through your Wolt contact. Before you create the connection:- Ask your Wolt contact for the Client Id and Client Secret of your own Wolt integration app. Wolt gives them to you when it registers your integration.
- Give Wolt these two details for your app: the redirect URI
https://webhooks.engini.io/api/auth/OAuthRedirectUrland the scopeoffline.

- Connection Name - Enter a name that helps identify the Wolt connection.
- Authentication Method - Select Custom OAuth 2.0.
- Callback URL - A read-only field that shows the address Wolt sends you back to after you sign in (
https://webhooks.engini.io/api/auth/OAuthRedirectUrl). Click the copy button next to it and give this address to your Wolt contact as the redirect URI of your integration app, together with theofflinescope. - Client Id - Enter the Client Id of your own Wolt integration app. You receive it from your Wolt contact.
- Client Secret - Enter the Client Secret of your own Wolt integration app. You receive it from your Wolt contact.
- Environment - Choose Production or Sandbox, as in the OAuth 2 method.
- Api Url - Filled in automatically from the Environment you chose. It can’t be edited.
- Venue Id - Filled in automatically after you sign in. It can’t be edited.
- Signin - This button stays greyed out (“Fill in to continue: Client Id, Client Secret”) until you fill in the Client Id and Client Secret. Then click Signin, sign in to Wolt and approve the access request.
- Save - Click Save to create the connection.
https://webhooks.engini.io/api/auth/OAuthRedirectUrl and grant the offline scope.
Triggers
Order Notification Trigger
Starts the workflow when Wolt sends a notification about an order, for example when its status changes.
- Add Conditions - Click Add Conditions to define conditions that narrow down which notifications start the workflow. To learn more about using filters, click here.
https://webhooks.engini.io/Wolt/v1
To start receiving order notifications:
- Ask your Wolt contact, once per venue, to send the order notifications for your venue to the address above, for Sandbox, Production or both.
- Make sure you have a Wolt connection signed in for that venue. Its Venue Id is filled in after you sign in.
- Create a workflow that begins with the Order Notification Trigger on that connection, and activate it.
- Id - The notification ID.
- Type - The notification type.
- Created At - When the notification was created.
- Order - Id - The order ID. Use it in actions such as Get Order or Accept Order.
- Order - Venue Id - The venue the order belongs to.
- Order - Status - The current order status.
- Order - Resource Url - The link to the order in Wolt.
Actions
Order actions work on one order, identified by its Order Id (map it from the Order Notification Trigger). Venue and menu actions work on your venue.Accept Order
Confirms to Wolt that you received the order and started preparing it.
- Order Id - Provide the unique identification string for the order you are accepting.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- Adjusted Pickup Time - A new pickup time for the order, in ISO 8601 format (for example, 2026-10-15T14:30:00Z).
Create a Menu
Sends your entire list of products, prices and categories from your system to Wolt.
- Venue Id - Provide the unique identification code assigned by Wolt to the venue this action works on. You can copy it from the Venue Id field of your Wolt connection, or get it from your Wolt contact. Example: 5f1a2b3c4d5e6f7a8b9c0d1e
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Get Current Delivery Provider
Checks who is currently responsible for delivering your orders.
Get Menu
Retrieves the menu that is currently live on Wolt.
- Venue Id - Provide the unique identification code assigned by Wolt to the venue this action works on. You can copy it from the Venue Id field of your Wolt connection, or get it from your Wolt contact. Example: 5f1a2b3c4d5e6f7a8b9c0d1e
Get Order
Retrieves the complete details of a specific order from Wolt.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
Get Timeslots for Next 7 Days for a Venue
Retrieves the schedule of available delivery or pickup windows for your venue over the coming week.
Get Venue Status
Retrieves whether your venue is currently open and able to receive new orders on the Wolt app.
Mark Deposits Returned
Tells Wolt that you returned the deposit to a customer for a specific order.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- Action - The deposit action you are reporting.
- Mark Deposit Items - The list of returned deposit items. Each item has a Deposit Description, Unit Count, Total Price Incl Vat and Vat Percentage. This is a list of objects, so it is filled with Initialize Object Array and each item is added to it with Append to Object Array. When there is a single item, Append to Object Array is not required.
Mark Order Delivered
Tells Wolt that the order was handed over to the customer.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
Mark Order Ready
Notifies Wolt that the order is prepared and waiting to be picked up.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
Mark Pickup Completed
Tells Wolt that the courier or customer picked up the order from your store.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
Reject Order
Declines an order.
- Order Id - Provide the unique identification code assigned by Wolt to the order.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- Reason - Required. A short explanation of why the order is declined.
- Code - The rejection code. Choose Generic, Items Unavailable or Venue Closing Soon.
Update Delivery Provider
Changes who delivers your orders.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Update Menu Item Inventory
Updates how much of a specific item you have left in stock.
- Venue Id - Provide the unique identification code assigned by Wolt to the venue this action works on. You can copy it from the Venue Id field of your Wolt connection, or get it from your Wolt contact. Example: 5f1a2b3c4d5e6f7a8b9c0d1e
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Update Menu Items
Updates specific fields of menu items.
- Venue Id - Provide the unique identification code assigned by Wolt to the venue this action works on. You can copy it from the Venue Id field of your Wolt connection, or get it from your Wolt contact. Example: 5f1a2b3c4d5e6f7a8b9c0d1e
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Update Menu Options
Updates specific fields of menu options.
- Venue Id - Provide the unique identification code assigned by Wolt to the venue this action works on. You can copy it from the Venue Id field of your Wolt connection, or get it from your Wolt contact. Example: 5f1a2b3c4d5e6f7a8b9c0d1e
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Update Time Slot Order Capacities for a Venue
Updates order capacities for given timeslots of your venue.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Update Venue Online Status
Sets your venue online or offline. Use it to manually toggle the venue.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- Status - Required. Choose Online or Offline.
- Until - Optional. The date and time, in ISO 8601 format (for example, 2026-10-15T18:00:00Z), until which the status applies.
Update Venue Opening Times
Updates the opening times of your venue.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Initialize Object Array
Creates a new object array variable in your workflow to store structured Wolt data for use in later steps.
- Variable Name - Enter the name of the variable that will hold the object array. This name will be used throughout the workflow whenever you refer to this object array.
- Object Element Type - Select the type of object the array will store. The selected type determines the structure of the array and opens its fields so you can fill in the values for the first entry.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Append to Object Array
Adds a new entry to an existing object array variable in your workflow.
- Variable - Select the object array variable you want to append to. This must be an already initialized object array.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Map Object Array
Transforms a list of data into a structured object array that can be used later in the workflow. It iterates over each item in the selected data list and maps it into a structured entry.
- Data List - Select or map the array or list of data you want to iterate over and transform.
- Object Name - Define the name of the temporary object that represents each item during the mapping. You will use this name when referencing fields from the current item.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
Send API Request
This activity allows you to send a custom API request directly to Wolt’s API.
- Base Url - The root URL of the Wolt API. It is filled in from your Wolt connection and can’t be edited here.
- Relative url - You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
- Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
- Body Type - Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
- Body - Contains any data that is being sent to the server.
- Add Headers - Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
- Add Queries - The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.