Skip to main content
Let’s learn how to connect Engini to Wolt. This integration lets businesses connect their own software through Engini to Wolt’s delivery network and marketplace: receive order notifications, manage orders, menus and venue availability, and keep them in sync with the rest of your workflows. To get started, you need a Wolt integration set up with your Wolt contact.

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.
  1. 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.
  2. Wolt sends you its requirements and terms, and issues test credentials once it has everything it needs.
  3. 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.
  4. When you are ready, Wolt launches the integration at a pilot venue in Production, the live environment.
In Engini, the connection’s Environment (Sandbox or Production) must match the Wolt environment your venue is in.

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 offline scope registered for it.
  • Order notifications only: send them to https://webhooks.engini.io/Wolt/v1.

Add a connection to Wolt in Engini

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here. Engini - Connections page
  3. Click on the “New Integration” option located at the top bar. Engini - New Integration button
  4. Choose the Wolt option from the available applications. Wolt - Choose Application
  5. Enter the following details in the “New Integration” form and press Save:
Note: There are two different authentication methods available, and the required fields differ depending on the option you choose. Please follow the relevant instructions based on your selected method.

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. Wolt - New Integration form, OAuth 2
  1. Connection Name - Enter a name that helps identify the Wolt connection.
  2. Authentication Method - Select OAuth 2.
  3. 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.
  4. Api Url - Filled in automatically from the Environment you chose. It can’t be edited.
  5. Venue Id - Filled in automatically after you sign in, from your Wolt sign-in. It can’t be edited.
  6. Signin - Click Signin, sign in to Wolt and approve the access request. Use the Wolt account that was set up for your integration.
  7. 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/OAuthRedirectUrl and the scope offline.
Wolt - New Integration form, Custom OAuth 2.0
  1. Connection Name - Enter a name that helps identify the Wolt connection.
  2. Authentication Method - Select Custom OAuth 2.0.
  3. 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 the offline scope.
  4. Client Id - Enter the Client Id of your own Wolt integration app. You receive it from your Wolt contact.
  5. Client Secret - Enter the Client Secret of your own Wolt integration app. You receive it from your Wolt contact.
  6. Environment - Choose Production or Sandbox, as in the OAuth 2 method.
  7. Api Url - Filled in automatically from the Environment you chose. It can’t be edited.
  8. Venue Id - Filled in automatically after you sign in. It can’t be edited.
  9. 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.
  10. Save - Click Save to create the connection.
In your Wolt integration app, register this redirect URI: 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. Wolt - Order Notification Trigger
  • Add Conditions - Click Add Conditions to define conditions that narrow down which notifications start the workflow. To learn more about using filters, click here.
You don’t copy an address from the trigger. Wolt sends order notifications to one Engini address, the same for Sandbox and Production: https://webhooks.engini.io/Wolt/v1 To start receiving order notifications:
  1. Ask your Wolt contact, once per venue, to send the order notifications for your venue to the address above, for Sandbox, Production or both.
  2. Make sure you have a Wolt connection signed in for that venue. Its Venue Id is filled in after you sign in.
  3. Create a workflow that begins with the Order Notification Trigger on that connection, and activate it.
Engini recognizes your venue and starts your active workflows that begin with the Order Notification Trigger. Warning: The connection’s Environment must match the Wolt environment the venue’s notifications come from. A Sandbox venue needs a Sandbox connection, and a Production venue needs a Production connection. In Add Conditions, the Order - Status options are: CREATED, PRODUCTION, READY, CANCELED, COURIER ARRIVAL, PICK-UP-COMPLETED, DELIVERED and REVIEW. The trigger makes the following information about the notification available to the next steps of your workflow:
  • 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. Wolt - Accept Order action
  1. Order Id - Provide the unique identification string for the order you are accepting.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • 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. Wolt - Create a Menu action
  1. 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
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The menu fields you can add are Id, Currency, Primary Language and Categories. Id is the ID of the menu, Currency is a currency code (for example, EUR) and Primary Language is a language code (for example, en). Categories is a list of objects, so it is filled with Initialize Object Array and each category is added to it with Append to Object Array. When there is a single category, Append to Object Array is not required.

Get Current Delivery Provider

Checks who is currently responsible for delivering your orders. Wolt - Get Current Delivery Provider action This action needs no input. It uses the venue from your Wolt connection.

Get Menu

Retrieves the menu that is currently live on Wolt. Wolt - Get Menu action
  • 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. Wolt - Get Order action
  • 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. Wolt - Get Timeslots for Next 7 Days for a Venue action This action needs no input. It uses the venue from your Wolt connection.

Get Venue Status

Retrieves whether your venue is currently open and able to receive new orders on the Wolt app. Wolt - Get Venue Status action This action needs no input. It uses the venue from your Wolt connection.

Mark Deposits Returned

Tells Wolt that you returned the deposit to a customer for a specific order. Wolt - Mark Deposits Returned action
  1. Order Id - Provide the unique identification code assigned by Wolt to the order.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following fields are required and are added through Add Field:
  • 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. Wolt - Mark Order Delivered action
  • 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. Wolt - Mark Order Ready action
  • 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. Wolt - Mark Pickup Completed action
  • Order Id - Provide the unique identification code assigned by Wolt to the order.

Reject Order

Declines an order. Wolt - Reject Order action
  1. Order Id - Provide the unique identification code assigned by Wolt to the order.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following fields are added through Add Field:
  • 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. Wolt - Update Delivery Provider action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The field you can add is Delivery Provider: choose Wolt or Self Delivery.

Update Menu Item Inventory

Updates how much of a specific item you have left in stock. Wolt - Update Menu Item Inventory action
  1. 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
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The field you can add is Data, the list of item inventories to update. Define an external ID, GTIN or SKU for each item you update. It is filled with Initialize Object Array and each entry is added with Append to Object Array. When there is a single entry, Append to Object Array is not required.

Update Menu Items

Updates specific fields of menu items. Wolt - Update Menu Items action
  1. 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
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The field you can add is Items Data, the list of menu items to update. Define an external ID, GTIN or SKU for each item you update. It is filled with Initialize Object Array and each entry is added with Append to Object Array. When there is a single entry, Append to Object Array is not required.

Update Menu Options

Updates specific fields of menu options. Wolt - Update Menu Options action
  1. 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
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The field you can add is Options Data, the list of menu options to update. Each option has an External Id (the ID of the item or option in your menu), a Price (in cents, for example 1250), a Vat Percentage (for example, 17) and Enabled. It is filled with Initialize Object Array and each option is added with Append to Object Array. When there is a single option, Append to Object Array is not required.

Update Time Slot Order Capacities for a Venue

Updates order capacities for given timeslots of your venue. Wolt - Update Time Slot Order Capacities for a Venue action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The fields you can add are a Schedule for each day of the week (Monday to Sunday) and Delivery Lead Time, in minutes (for example, 30). Each day’s schedule is a list, filled with Initialize Object Array and Append to Object Array.

Update Venue Online Status

Sets your venue online or offline. Use it to manually toggle the venue. Wolt - Update Venue Online Status action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following fields are added through Add Field:
  • 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. Wolt - Update Venue Opening Times action
  • Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The fields you can add describe one opening period: Availability - Opening Day, Availability - Opening Time, Availability - Closing Day and Availability - Closing Time. The days are chosen from a list of the days of the week, and the times are entered as hours and minutes (for example, 09:00 and 22:00).

Initialize Object Array

Creates a new object array variable in your workflow to store structured Wolt data for use in later steps. Wolt - Initialize Object Array action
  1. 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.
  2. 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.
  3. 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. Wolt - Append to Object Array action
  1. Variable - Select the object array variable you want to append to. This must be an already initialized object array.
  2. 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. Wolt - Map Object Array action
  1. Data List - Select or map the array or list of data you want to iterate over and transform.
  2. 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.
  3. 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. Wolt - Send API Request action
  1. Base Url - The root URL of the Wolt API. It is filled in from your Wolt connection and can’t be edited here.
  2. 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.
  3. Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
  4. 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.
  5. Body - Contains any data that is being sent to the server.
  6. 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.
  7. 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.