> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engini.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Wolt
Learn how to connect Wolt to Engini, allowing businesses to connect their own software through Engini to Wolt’s delivery network and marketplace.
# Getting started with Wolt
### Prerequisites
* A Wolt account.
* Active access token
## Connecting Engini to Wolt
1. Enter your Engini account at [https://app.engini.io.](https://engini.io/)
2. Navigate to Connections page by clicking on the Connections on the left side bar or by clicking [here](https://app.engini.io/connections).
3. Click on the “New Integration” option located at the top bar.
4. Choose “Wolt” option from available applications.
5. Enter the following details in the “New Integration” form:
1. *Connection name* – A unique identifier for the connection within Engini
2. *Environment* - Choose one of the environment:
* *Production*- The **Production** environment is the "live" version of the API where real business happens.
* *Sandbox*- The Sandbox is your "practice field." It is an isolated testing environment where you can build and test your application without any real-world consequences.
3. *Api Url -* The base URL provided by Wolt depending on the environment you selected above.
4. Venue ID - Your ID will be paste automatically after Sign in.
5. *Signin -* Click Signin and log in with the Wolt account used to create the project. This ensures access to the correct OAuth credentials and permissions.
6. Click on the Save button to the save the connection.
# Trigger
## Order Notification Trigger
A webhook message sent from Wolt to Engini whenever an order's status changes.
* *Add Conditions -* Click Add Conditions to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](/help/workflows/workflow-editor#add-conditions).
# Actions
## Accept Order
Sent from your system to Wolt to confirm you have received and started preparing the order.
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](/help/workflows/workflow-editor#add-fields).
## Create a Menu
This activity sends your entire list of products, prices, and categories from your system to Wolt.
1. *Venue ID -* Provide a unique identification code assigned by Wolt to a specific venue.
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](/help/workflows/workflow-editor#add-fields).
[**Objects Array**](/help/apps/wolt#initialize-object-array) **Fields**: Some fields in the Create a Menu activity are object arrays, meaning they accept a list of objects, not a single value.
* **Categories\[] (Required)**
The menu must include at least one category.
Each category is added as a separate object inside the categories array.
* **Name\[] / Description\[] (Translations)**
Category and item names are provided as translation arrays.
Each entry includes a language (lang) and its text value (value).
* **Nested objects**
A category can include additional nested data such as items, availability windows, and item configuration.
These are also defined as arrays inside the parent object.
**How to build the structure**
Start by initializing the object array (e.g., categories).
Then append one object at a time (one category, one item, etc.), following the same nesting hierarchy.
**Required**
To create a valid menu, the following fields are required:
* Currency
* Primary Language
* Categories
Each one of them is an array of objects. The array is initialized using [Initialize Object Array](/help/apps/wolt#initialize-object-array), and each object is added to it with [Append to Object Array](/help/apps/wolt#append-to-object-array). In case of a single object, the Append to Object Array is not required.
## Get Current Delivery Provider
This activity checks and retrieve who is currently responsible for delivering your orders.
## Get Menu
This activity retrieve the current menu that is live on the Wolt.
*Venue Id*- Provide a unique identification code assigned by Wolt to a specific menu.
## Get Order
This activity retrieve the complete details of a specific order from Wolt.
*Order Id* - Provide a unique identification code assigned by Wolt to a specific order.
## Get Timeslots for Next 7 Days for a Venue
This activity retrieves the schedule of available delivery or pickup windows for a specific store over the coming week.
## Get Venue Status
This activity retrieves whether a specific store is currently open and able to receive new orders on the Wolt app.
## Mark Deposits Returned
This activity tells Wolt that you have successfully returned the deposit to a customer for a specific order.
1. *Order Id -* Provide a unique identification code assigned by Wolt to a specific 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](/help/workflows/workflow-editor#add-fields).
**Object Array Fields :**
* **Items \[]** - Required, List of returned deposit items.
Is an array of objects. The array is initialized using [Initialize Object Array](/help/apps/wolt#initialize-object-array), and each object is added to it with [Append to Object Array.](/help/apps/wolt#append-to-object-array)In case of a single object, the Append to Object Array is not required.
## Mark Order Delivered
This activity tells Wolt that the order has been successfully handed over to the customer.
*Order Id -* Provide a unique identification code assigned by Wolt to a specific order.
## Mark Order Ready
This activity notifies Wolt that the order has been prepared and is now waiting to be picked up.
*Order Id -* Provide a unique identification code assigned by Wolt to a specific order.
## Mark Pickup Completed
This activity tells Wolt that the courier or customer has physically picked up the order from your store.
*Order Id -* Provide a unique identification code assigned by Wolt to a specific order.
## Reject Order
This activity allows you to decline an order.
1. *Order Id -* Provide a unique identification code assigned by Wolt to a specific 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](/help/workflows/workflow-editor#add-fields).
## Update Delivery Provider
This activity update the delivery Provider.
* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
## Update Menu's Item Inventory
This activity lets you quickly update how much of a specific item you have left in stock.
1. *Venue Id*- Provide a unique identification code assigned by Wolt to a specific menu.
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](/help/workflows/workflow-editor#add-fields).
**Object Array Fields :**
* **Data \[]** - Item inventories to update. You must define either external id, gtin or sku fields for each item to update
Is an array of objects. The array is initialized using [Initialize Object Array](/help/apps/wolt#initialize-object-array), and each object is added to it with [Append to Object Array](/help/apps/wolt#append-to-object-array). In case of a single object, the Append to Object Array is not required.
## Update Menu Items
Update specific fields of menu items.
1. *Venue Id*- Provide a unique identification code assigned by Wolt to a specific menu.
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](/help/workflows/workflow-editor#add-fields).
**Object Array Fields :**
* **Data \[]** - Item inventories to update. You must define either external id, gtin or sku fields for each item to update
Is an array of objects. The array is initialized using [Initialize Object Array](/help/apps/wolt#initialize-object-array), and each object is added to it with [Append to Object Array](/help/apps/wolt#append-to-object-array). In case of a single object, the Append to Object Array is not required.
## Update Menu Options
Update specific fields of menu options.
*Venue Id*- Provide a unique identification code assigned by Wolt to a specific menu.
**Object Array Fields :**
* **Data \[]** - Item inventories to update. You must define either external id, gtin or sku fields for each item to update
Is an array of objects. The array is initialized using [Intialize Object Array,](/help/apps/wolt#initialize-object-array) and each object is added to it with [Append to Object Array](/help/apps/wolt#append-to-object-array). In case of a single object, the Append to Object Array is not required.
## Update Time Slot Order Capacities for a Venue
Update order capacities for given timeslots for a 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](/help/workflows/workflow-editor#add-fields).
## Update Venue Online
Update the online status of the venue. This can be used to manually toggle a venue online or offline.
* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).
## Update Venue Opening Times
Update the opening times of 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](/help/workflows/workflow-editor#add-fields).
**Object Array Fields :**
* **Availability \[]** - Venue's operating hours.
Is an array of objects. The array is initialized using [Intialize Object Array](/help/apps/wolt#initialize-object-array), and each object is added to it with [Append to Object Array](/help/apps/wolt#append-to-object-array). In case of a single object, the Append to Object Array is not required.
## Initialize Object Array
This activity initializes an object array in Wolt and stores a single structured entry based on the selected object type
1. *Variable name -* Choose a significant name.
2. *Object Element Type -* This field defines the type of data the array will store, such as addresses and emails .The selected type determines the structure of the array and its use in subsequent actions.
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](/help/workflows/workflow-editor#add-fields).
## Append to Object Array
This action allows you to add a new item to an existing object array within your workflow.
1. *Variable* - Select the variable that contains the object array you want to append to. The chosen variable should already be defined in your workflow.
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](/help/workflows/workflow-editor#add-fields).
## Map Object Array
We use this activity when there is an array of data that requires transformation into a different structure.
1. *Data List -* Choose a data list that you’ve obtained from previous activities in your workflow. This data list contains an array of objects that you want to process and transform.
2. *Object Name -* Define the type of objects from the drop down that will be stored within the array. According to the object element type you chose, the fields in step 3 will be defined. To learn more about object element types, go to ‘Object element types’.
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](/help/workflows/workflow-editor#add-fields).
## Send API Request
The Send API Request action allows you to call any Wolt API endpoint directly, giving you full control over the URL, HTTP method, headers, query parameters, and request body.
1. *Base URL –* The Salesforce instance domain that serves as the root for the API call.
2. *Relative URL –* The specific API path appended to the base URL (for example, a REST resource).
3. *Method –* The HTTP method used for the request (GET, POST, PUT, PATCH, DELETE).
4. *Body Type –* Defines the content type of the request payload (commonly application/json).
5. *Body –* The request payload sent to Salesforce, structured according to the selected API endpoint.
6. *Add Headers –* Used to include additional HTTP headers such as authorization or custom headers.
7. *Add Queries –* Adds query string parameters to the request URL.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.