GrabFood - Connection & Settings — Wiresk Documentation

Estimated reading time: 21 min

GrabFood is an online food delivery service offered by Grab, a prominent super-app in Southeast Asia. It connects users with a wide range of restaurants, allowing them to order meals for delivery through an intuitive mobile app or website.

GrabFood integration with Wiresk allows businesses to handle essential operations efficiently and improve their responsiveness. With this integration, restaurants can manage their GrabFood activities directly from Wiresk.

Prerequisite:
Using GradFood with Wiresk requires a Grab Merchant account. Sign up to partner with Grab here.
For developers, see Grab API endpoint documentation here.
See Grab FAQs to learn more about how to integrate GrabFood to your System.

Connect GrabFood to Wiresk Copy Link

A connection to your Grab Merchant account is needed so we can sync it with our platform.

There are two ways to connect your app to Wiresk:

In “My apps” section, where you can manage your connections (select or create your group first to get access to this section, refer to the Group system ).
While building your Flow, you can easily establish a connection to your app directly within the Flow builder. This can be done during the setup of either a Trigger or a Method.

This guide explains how to set up a connection in “My apps” section, which is essentially the same process as creating one on-the-go.

Add GrabFood app in Wiresk Copy Link

On your Wiresk’s Dashboard, select your Group.
On the left panel, go to “My apps” and select
Search the app name in the search field or select it in the apps list.

Animated image GIF, showing the step of how to create an app connection. First, select the group then select My Apps tab, and click on the "+ create" button.

On the connection settings panel, enter the credentials given to you by GrabFood company into the corresponding fields.
- Find your credentials in your Grab Developer Portal > Project details > Credentials.

Screenshot of Wiresk "Add apps" screen. It shows the setting to add GrabFood app in Wiresk. Red arrows shows fields like GrabFood client Id, GrabFood client secret and environment.

Give a Name to the connection.
Enter you GrabFood Client ID.
Enter your GrabFood Client Secret.
Chose your connection Environment.
Click on “Create App” button.

Voila! Your GrabFood app connection is ready. You can now use it to build your Flows.

Basic understanding of Flow creation Copy Link

Now that your app is linked to Wiresk, you’re ready to start building Flows.

Simple steps to create a Flow ↓

Select your Group, then on the Flow management screen click on “Create Flow”.
On the new screen, name the new Flow.

GIF animated screen of Wiresk, showing the way to create a new Flow.

Add a Trigger that will start your Flow

Flows can be executed by multiple Triggers, depending on the desired workflow. For example, you could use scheduled Triggers with different recurrence rules alongside a Webhook Trigger for immediate, event-driven runs of the Flow. If you choose to “Run Once“, the Flow will execute using only one Trigger and its sample data.

Click on the (+) button to open the Trigger settings side panel.
On the settings side panel, click on the “+ Add” button.

Screenshot of the Wiresk side panel titled “Trigger.” The panel shows a section labeled “All Triggers” with a blue “+ Add” button for inserting a new Trigger.

On the Trigger selection screen, search your app or select it from the list below the screen.

Screenshot of Wiresk Trigger setting screen. Red arrows shows that you can wether search your app in the search or or select it in the list below.

Select your preferred Trigger on the next screen and customize its settings.

As mentioned in “How to connect your app to Wiresk” above, during your Trigger settings, you can create a new connection to your apps at this stage.

Add a Method that will execute a task

The Method will perform a specific task on a particular app or service you’ve connected to Wiresk like get info or send emails.

You can add at least 1 or multiple Methods for complex Flows (a maximum of 255 Methods).

On the Flow builder, select the (+) plus button next the Trigger button.
Search or scroll down to select the app that will perform a task.
Configure the Methods settings, refer to it documentation in our Help Center.

Screenshot of Wiresk Flow Builder with a Flow named “Flow Example.” The canvas shows a Gmail Trigger on the left connected to an empty step placeholder marked with a plus icon in the center. On the right, the panel lists available apps and tools. A search bar is displayed at the top of the panel for filtering apps. Red arrows highlight the empty step placeholder, the search bar, and items in the app list.

Add Wiresk Tools to your Flow

If you want to build a complex Flow, Wiresk offers a selection of tools at your disposal. Refer to Wiresk’s Tools

To add Tools in your Flow, Follow the same step as adding the Methods.

On the Flow builder screen, click on the plus button (+) then just click on the “Tool” tab and select the Tool that you want to add.

Screenshot of Wiresk Flow Builder showing a Gmail Trigger connected to an empty Method placeholder. A red arrow points to the empty step circle with a plus sign where the next action will be added. On the right side, the “Tool” tab is selected in the panel. Another red arrow highlights the “Tool” tab label at the top. A search bar is shown above a list of available tools.

You can refer to “How to Create a Flow” tutorial for more detailed instructions, including step-by-step guidance on mapping and configuration.

GrabFood Methods Copy Link

What your automation will do…

Wiresk simplifies the integration of GrabFood with your current POS. Use the available methods in Wiresk to:

Eliminate manual order entry: When a customer places an order through GrabFood, it automatically appears in your POS system. This allows your restaurant staff to focus on fulfilling orders efficiently and providing excellent customer service.
Maintain accurate menus: Updates made to your GrabFood menu, such as adding new items or marking items as unavailable, are instantly reflected in your POS system. This eliminates the need for manual updates, saving time and reducing the risk of errors.
Manage campaigns with ease: Easily manage and launch restaurant campaigns directly from within the your POS interface.

MANAGE ITEM Copy Link

Update Item Copy Link

This Method is used for minor updates to specific items such as the price, available status, max stock, advanced pricing, and purchasability in the menu.

▪️ Updating item price to zero is not allowed.
▪️ All item records with the same id under the same merchant are updated.
▪️ To mark an item as UNAVAILABLE, the max Stock value has to be set as 0. Item will be set to “AVAILABLE” if max Stock > 0.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Item
Connection*	Select your connection or create one.
Map Fields [+ Add Field] you can add optional fields: Price, Available status, Advanced Pricings, Purchasabilities.
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
ID*	The record’s ID (ID of the item or modifier) on the partner system. All item records with the same `id` under the same merchant are updated.
Additional fields
Price	In minor unit format. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit. Note: The prices on your menu should be exclusive of tax (except for Merchant in Singapore). Tax rate will be configured in GrabFood’s system by the Integration Managers.
Available Status	Select AVAILABLE – UNAVAILABLE – UNAVAILABLE TODAY To mark an item as UNAVAILABLE, the `max Stock` value has to be set as 0. Item will be set to “AVAILABLE” if `max Stock` > `0`. What is Available Status?
Max Stock	Available stocks under inventory for this item. Auto reduce when there is order placed for this item. Note: It is necessary to set `max Stock` to 0 if the `available Status` of the item is “UNAVAILABLE”. Item will be set to “AVAILABLE” if `max Stock` > 0.
Advance Pricings	Price configuration (in minor unit) for different service, order type and channel combination. If a service type does not have a specified price, it will utilize the default price of the item. Key: select the advance pricing key. Possible Values: `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Price: price in minor unit. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit.
Purchasabilities	Purchasability is set to true by default for all service type, unless it is explicitly set to false. Modifier will reuse it’s item’s purchasability. Key: select the advance pricing key. Possible Values: `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Purchasable: `True - False`

(*) required field

Update Item Modifier Copy Link

This Method is used for minor updates to specific Modifiers such as the price, advanced pricing, and available status in the menu.
▪️ All item records with the same id under the same merchant are updated.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Item Modifier
Connection*	Select your connection or create one.
Map Fields [+ Add Field] you can add optional fields: Price, Available status, Advanced Pricings, Purchasabilities.
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
ID*	The record’s ID (ID of the modifier) on the partner system. All item records with the same `id` under the same merchant are updated.
Name*	The modifier’s name. Used as identifier to locate the correct modifier. (This field is required from Grab but it seems not working properly).
Price	In minor unit format. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit. Note: The prices on your menu should be exclusive of tax (except for Merchant in Singapore). Tax rate will be configured in GrabFood’s system by the Integration Managers.
Additional fields
Is Free	Allows the modifier’s price to be explicitly set as zero. Possible values are as follows: `isFree` && `price == 0` sets the modifier’s price to zero. `isFree` && `price > 0` returns an error message that “price cannot be set to > 0, if modifier is free”. `!isFree` && `price > 0` sets the modifier’s price to the defined price. `!isFree` && `price == 0` does not update the modifier’s price and reuses the existing price.
Available Status	Select AVAILABLE – UNAVAILABLE – UNAVAILABLE TODAY To mark an item as UNAVAILABLE, the `max Stock` value has to be set as 0. Item will be set to “AVAILABLE” if `max Stock` > `0`. What is Available Status?
Advance Pricings	Price configuration (in minor unit) for different service, order type and channel combination. If a service type does not have a specified price, it will utilize the default price of the item. Key: select the advance pricing key. Possible Values: `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Price: price in minor unit. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit.

(*) required field

MANAGE ORDER Copy Link

List Copy Link

This Method is used to retrieve the list of orders for an outlet, including order details and the state of each order.

▪️ This Method is not available in staging environment. You may ignore the URL path provided.
▪️ You can only retrieve orders from a maximum of 7 days before today. E.g. If today is 7 November, the earliest date you can get orders for is 31 October.
▪️ Increment page by 1 for every request until the more parameter returned is false.
▪️ For orders placed on a previous day but completed on the current date, the date should be set to the order completion date and the page should be set to 0.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	List
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Date*	The date of your report. Example: `2020-01-20`
Page*	Specify the page number for the report. Example: `1`

(*) required field

Accept Order Copy Link

This Method is only applicable to partners that have configured their store for manual order acceptance.
See more about “Accept/Reject orders” on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Accept Order
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.

(*) required field

Cancel Order Copy Link

This Method is used to cancel an order.
See more about “Cancel Orders” endpoint rules and conditions on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Cancel Order
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.
Cancel Code*	Select the cancellation reason: 1001 (Items are unavailable) 1002 (I have too many orders now) 1003 (My shop is closed) 1004 (My shop is closing soon)

(*) required field

Check Cancellation Eligibility Copy Link

This Method is used to check if an order can be cancelled.
See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Check Cancellation Eligibility
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.

(*) required field

Reject Order Copy Link

This Method is used to reject an order.

▪️ It is only applicable to partners that have configured their store for manual order acceptance.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Reject Order
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.

(*) required field

Set Order Ready Time Copy Link

This Method is used to provide Grab with a more accurate order ready time.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Set Order Ready Time
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.
Map Fields
Ready Time*	The new order ready time for this order, based on ISO_8601/RFC3339. Example: `2025-01-09T14:30:00Z` `YYYY-MM-DD` represents the date (year, month, day). `T` separates the date and time components. `HH:mm:ss` represents time in hours, minutes, and seconds. Time Zone Support Use `Z` for UTC (Coordinated Universal Time), e.g., `2025-01-09T14:30:00Z`. Use offsets from UTC in the format `±hh:mm`, e.g., `2025-01-09T14:30:00+05:30` (UTC+5:30) or `2025-01-09T14:30:00-07:00` (UTC-7:00).

(*) required field

Update Order Copy Link

This Method is used to edit an order. You can delete items, update item quantity, add item for replacement.
⚠️ All ordered items must be included in the Method regardless of whether they have changes or not.
▪️The edited order will be submitted to partner via the submit order webhook, with the same order ID but the isMexEditOrder value changing from false to true.
▪️Update item’s modifier is not supported.
▪️Update item’s price is not supported.
▪️Customer is not able to select item with modifier in item replacement options. If merchant decided to replace a different item that has modifier options, please note that modifier will not apply to the item.
See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Order
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.
Map Fields
Items* Specify the array of all items in the order, including deleted, added, updated and unchanged items.	[⊕ Element][⊕ Map] Add fields or Map it from a Data Source. See Field Mapping. Item ID: The item’s ID in Grab system that can be obtained from the Submit Order Webhook request payload parameters, under `items[].grabItemID`, or `items[].outOfStockInstruction.replacementGrabItemID` for item replacement. External item ID from Partner system is only supported when `ADDED` status and `External Item ID: true`. Status: The item’s status. Leave empty string if there is no change to the item. UPDATED – DELETED – ADDED Quantity: The item’s quantity. If the item is not being updated or deleted, use the original quantity. External Item ID: True – False Only applicable for “`ADDED`” status. Indicate if the `itemID` is an external item ID. Grab checks for the items that are mapped to the provided item ID, considering their availability. If multiple Grab items are found to be mapped to the provided external item ID, the last updated item will be chosen. If no suitable record is found, an 400 error will be returned to the partner, indicating that the submitted external item ID cannot be edited.

(*) required field

Update Order Status Copy Link

This Method is for restaurant that set as Delivered by Partner only, return a message error “order isn’t delivered by restaurant” if not set.
The partner uses this Method to report the state of the delivery to GrabFood.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Order Status
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.
Map Fields
From Status*	Specify the order’s initial state: ACCEPTED – FIND DRIVER – COLLECTED
To State*	Specify the order’s new state: FIND DRIVER – COLLECTED – DELIVERED

(*) required field

Update Order as Ready Copy Link

This Method is used to mark an order as ready for delivery. You can only update it once for an order.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Order as Ready
Connection*	Select your connection or create one.
Matching Criteria
Order ID*	Get the order ID from the Method “List” orders. Refer to Grab FAQs for more details about order ID and short Order Number.

(*) required field

MANAGE MENU Copy Link

Notify Menu Update Copy Link

This Method is used to notify Grab that the menu has been updated. Grab will call the Method “Set Partner Menu” from Partner, to get the latest up-to-date menu. Grab will replace the existing menu with the new one.
⚠️ Before using this Method, make sure:
▪️ The Get menu webhook is ready.
▪️ The merchant(s) has already integrated with GrabFood. If not, you will receive a 403 error stating that the merchant not been integrated yet.
▪️ For newly integrated merchant(s), there may be some caching of the store integration status. It is recommended that partners send the menu update notification 10 minutes after the store integration is activated.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Notify Menu Update
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).

(*) required field

MANAGE STORE Copy Link

Update Store Status Copy Link

This Method allows partners to pause or unpause their store on GrabFood. Partners can only choose to pause their store for:
▪️ 30 minutes
▪️ 1 hour
▪️ 24 hours

⚠️ Notes:
▪️ Sending a pause or unpause request while the store is already in the same status will result in a conflict error.
▪️ Partners can use this Method to unpause the store if they wish to unpause it before the end of the pause period.
▪️ Partner can perform the pause using merchant device or reach out to Ops team if longer pause is needed.
▪️ The store will automatically resume operations once the specified pause duration has end.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Store Status
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Map Fields
Is Pause*	Possible values: True – False
Duration*	If you pause the store, specify a duration : “30m” “1h” “24h” “No Duration”.

(*) required field

MANAGE PARTNER ENDPOINT Copy Link

Get Partner Access Token Copy Link

This Method is used to get from GrabFood, a partner token for a specific partner URL.

GrabFood will need to request for a new token if:
▪️ No token exists
▪️ Existing token is expiring
▪️ There is a 401 Unauthorized response

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Get Partner Access Token
Connection*	Select your connection or create one.
Map Fields
Client ID*	Enter you GrabFood Client ID.
Client Secret*	Enter you GrabFood Client Secret.
URL*	URL of your system to request access token for example: https://name.api.test.ovh

(*) required field

Response sample from: Get Partner Access Token

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Il9kZWZhdWx0IiwidHlwIjoiSldUIn0....",
  "token_type": "Bearer",
  "expires_in": 604799
}

Copy

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Il9kZWZhdWx0IiwidHlwIjoiSldUIn0....",
  "token_type": "Bearer",
  "expires_in": 604799
}

Set Partner Menu Copy Link

This Method is set by partners to provide the most up-to-date menu data in response to requests initiated by the Menu Update Notification endpoint. GrabFood typically sends request to this endpoint to get the latest outlet menu from the partner’s database.

⚠️ This Method only activate when “Notify Menu Update” is Triggered.
You need to configure the Get Menu Endpoint URL in Grab Portal beforehand, go to GrabFood POS integration > Configurations > Edit.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Set Partner Menu
Connection*	Select your connection or create one.
Map Fields
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Partner Merchant ID*	Partner store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to External Store ID).
Currency*	Code: Country code (<= 3 characters). Symbol: Currency Symbol (<= 3 characters). Exponent*: The log base 10 of the number of times we have to multiply the major unit to get the minor unit. Should be 0 for VN and 2 for other countries (<= 2 characters). Refer to Country and Currency doc.
Selling times: It represents the availability schedule for a category or item within the menu. It allows partners to set when a particular item or category is available, such as during breakfast, lunch, or dinner. The selling time can be applied at both the category and item levels, providing greater flexibility for configuring the menu based on specific time periods. [⊕ Element][⊕ Map] Add more selling times or Map it from a Data Source. See Field Mapping. The Selling Times feature follows these guidelines: ▪️ Each outlet must have at least 1 and not more than 20 sellingTimes.* If less than 1 sellingTimes entry is provided in the array, an error will be returned. If more than 20 sellingTimes entries are provided, the system will truncate the excess entries. ▪️ The selling time IDs should remain consistent and not swapped with each other. Reuse the selling time IDs for subsequent menu syncs and avoid assigning new IDs unless there is a change to minimize unnecessary updates. ▪️ The selling time duration (`selling Times.start Time` and `selling Times.end Time`) must be in UTC format. Example: For a schedule starting on January 9, 2023, at 8:00 AM (UTC+8), `selling Times.start Time` should be set as `"2023-01-09 00:00:00"`. ▪️ Overlapping is allowed for the service hours periods across different selling times. Breakfast menu selling time ~ Monday: `08:00 - 12:00` Regular menu selling tIme ~ Monday: `08:00 - 22:00` ▪️ A maximum of 1 `sellingTimes` is allowed for each category and item. If no selling time is specified for an item, it will inherit the selling time from the category; if a selling time is specified for the item, it will override the category’s selling time. ▪️ Duplicates of `selling Times` with similar duration and service hour periods are not allowed. ▪️ Different `open Period Type` can be applied for the selling time service hours (`selling Time.service. Hours`): – `Open All Day`: Indicates the item is available 24 hours. – `Close All Day`: Indicates the item is unavailable for the entire day. – `Open Period`: Defines availability for specific time periods. Local time format is expected. For example, `"08:00"`. A maximum of 3 periods can be defined per day for the service hours. Exceeding this will return an error. 💡 Tip: Utilize multiple periods within the service hours to align item selling times with different sessions. If available only during breakfast, configure the selling time with a single period: `08:00 – 11:00`. If available all day, configure the selling times with multiple periods: `08:00 – 11:00`, `12:00 – 17:00`, and `19:00 – 22:00`. For more details, refer to Item Selling time Menu Structure
Selling Times.ID	Set an ID of the selling times, e.g., “SELLINGTIME-01” (<= 64 characters).
Selling Times.Name	Set a Name of the Selling times, e.g., “Breakfast” (<= 30 characters).
Selling Times.Services Hours	Monday* _Open Period Type: Defines the specific time period during which the menu is available. Select: Open Period, Open All Day or Close All Day _Periods (Define “Periods” only if the “Open Period Type” is set to “Open Period”) [⊕ Element][⊕ Map] Add more fields or Map it from a Data Source. . Start Time: The open start time in 24h format. Local time format is expected. . End Time: The open end time in 24h format. Local time format is expected. Same field settings for the other days: Tuesday – Wednesday* – Thursday* – Friday* – Saturday* – Sunday*
Selling Times.Start Time*	Define the starting date and time of the selling time duration. This must be in UTC format. Example: For a schedule starting on January 9, 2023, at 8:00 AM (UTC+8), the field should be set as `"2023-01-09 00:00:00"`.
Selling Times.End Time*	Define the ending date and time of the selling time duration. This must be in UTC format.
Categories* [⊕ Element][⊕ Map] Add more categories or Map it from a Data Source. See Field Mapping. Categories are the categorization of items in a menu. For example: Value Meal, Limited Time Offer, Best Seller. Categories have the following rules: ▪️ A menu should have minimum 1, maximum 100 categories: If there is less than 1 category, you will get an error. If there are more than 100 categories, GrabFood truncates the rest. ▪️ Category name has a character limit of 60. ▪️ A category cannot be created without a name. ▪️ A category must have at least 1 item entry; it cannot be created without items. ▪️ The category IDs should remain consistent and be reused for subsequent menu syncs, unless there is a change, to minimize unnecessary updates.
Categories.ID*	The category’s ID that is on the partner system. This ID should be unique (<= 64 characters).
Categories.Available* Status	Select “`AVAILABLE`” “`UNAVAILABLE`” “`HIDE`“ The status for the category. Refer to FAQs for more details about availableStatus.
Categories.Selling Time* ID	The selling time’s ID for the category. All items within the category will apply the same selling time unless there is another selling time specified for the item.
Categories.Name*	The name of the category (<= 60 characters).
Categories.Name Translation	Translation of the category name. Only support up to 1 translated language. Refer Menu Translation. Name EN: English Name KH: Khmer
Categories.Sequence	Display order of the category within the menu.
Categories.Items* Items are the products partners are displaying on GrabFood. For example: Big Burger Fries Hawaiian pizza	[⊕ Element][⊕ Map] Add more items or Map it from a Data Source. See Field Mapping. ID: The item’s ID in the partner system. This ID should be unique (<= 64 characters). Name: The name of the item (<= 80 characters). Available Status: Select AVAILABLE – UNAVAILABLE – HIDE – UNAVAILABLE TODAY ⚠️ In order to set an item as `"UNAVAILABLE"`, it is required to update both the `available Status` and `max Stock` fields, whereby the `maxStock` should be set to 0. Name Translation* : Translation of the item name. Only support up to 1 translated language. Refer Menu Translation. Name EN = English, Name KH = Khmer Description: The description of the item. There is a custom length limit of 2000 for `VN`.(<= 300 characters). Description Translation: Translation of the item description. Only support up to 1 translated language. Refer Menu Translation. Description En, Description KH. Sequence: Display order of the item within the menu. Price: The item’s price in minor format. For example: 1900 means $19 with `currency.exponent` as 2. Refer to FAQ to determine whether the pricing should be tax-inclusive or tax-exclusive. Photos: Your image URL link. Only 1 image is supported. Refer to FAQs for more details about images formats. Special Type: Possible values: `alcohol`,`tobacco,meal_for_one` When set as “`alcohol`“: The item does not appear in the cross-sell checkout section. The item does not get promoted in the “Recommended for you” section. There is an explicit legal age consent when consumers try to check out with that item. ⚠️ The merchant(s) must be enabled for alcohol sales in order to sell items with the special type `alcohol`. Please reach out to your integration support team for this setup. Selling Time ID: The selling time’s ID for the item. This value overrides the category’s selling time if it is different. Empty value implies the category’s selling time will be applied. Max Stock*: Available stocks under inventory for this item. Auto reduce when there is order placed for this item. Empty value implies no limit. ⚠️ It is necessary to set `maxStock` to 0 if the `availableStatus` of the item is `"UNAVAILABLE"`. Item will be set to `"AVAILABLE"` if `maxStock` > 0.
Item.Advanced Pricing	Price configuration (in minor unit) for different service, order type and channel combination. If a service type does not have a specified price, it will utilize the default price of the item. Refer Service Based Menu. [+ Add Field] Add prices for multiple service types. `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Price in minor unit. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit.
Item.Purchasability	Purchasability is set to true by default for all service type, unless it is explicitly set to false. Modifier will reuse it’s item’s purchasability. Refer Service Based Menu. [+ Add Field] Add multiple purchasability fields. `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Value: `True - False`
Item.Modifier Groups Modifier Groups are the different options that a consumer can select within an item. For example: Choice of Crust Sugar Level Extra Toppings	[⊕ Element][⊕ Map] Add more Modifier Groups or Map it from a Data Source (see Field Mapping). Max 30 allowed per item. Refer to Modifier groups for more information. ID: The modifier group’s ID that is on the partner system. This ID should be unique (<= 64 characters). Name: The name of the modifier group (<= 50 characters). Available Status: Select AVAILABLE – UNAVAILABLE – HIDE – UNAVAILABLE TODAY ⚠️ The item may be marked as `"UNAVAILABLE"` if no available modifier to be selected within the required modifier group where `"selection Range Minimum": 1`. Selection Range Maximum: The maximum quantity of the modifiers to be selected. Refer to FAQs for more details about selection range. Selection range Minimum: The minimum quantity of the modifiers to be selected. Refer to FAQs for more details about selection range. Name translation: Translation of the modifier group name. Only support up to 1 translated language. Refer Menu Translation. Name EN* = English, Name KH = Khmer Sequence: Display order of the modifier group within the menu.
Modifier Groups.Modifiers Modifiers are the selections within a modifier group. For example: 100% Sugar 50% Sugar No Ice	Max 100 per modifier Group. Refer to Modifiers for more information. [⊕ Element][⊕ Map] Add more Modifiers or Map it from a Data Source. See Field Mapping. ID: The modifier’s ID that is on the partner’s system. This ID should be unique (<= 64 characters). Name: The name of the modifier (<= 40 characters). Name translation: Translation of the modifier name. Only support up to 1 translated language. Refer Menu Translation. Name EN = English, Name KH = Khmer Available Status: The status for the modifier. Refer to FAQs for more details about availableStatus. Select AVAILABLE – UNAVAILABLE – HIDE – UNAVAILABLE TODAY Price: The modifier’s price in minor format. Refer to FAQs for more details about tax. Sequence*: Display order of the modifier within the menu.
Modifiers.Advanced Pricings	Price configuration (in minor unit) for different service, order type and channel combination. If a service type does not have a specified price, it will utilize the default price of the item. Refer Service Based Menu. [+ Add Field] Add prices for multiple service types. `Delivery_OnDemand_GrabApp Delivery_Scheduled_GrabApp SelfPickUp_OnDemand_GrabApp Dineln_OnDemand_GrabApp Delivery_OnDemand_StoreFront Delivery_Scheduled_StoreFront SelfPickUp_OnDemand_StoreFront` Price in minor unit. for example: $1 = 100 cents $2.50 x 100 = 250, is the minor unit.

(*) required field

Response sample from: Set Partner Menu

{
  "merchantID": "1-CYNGRUNGSBCCC",
  "partnerMerchantID": "Partner-ABECU",
  "currency": {
    "code": "SGD",
    "symbol": "S$",
    "exponent": 2
  },
  "sellingTimes": [
    {
      "startTime": "2022-03-01 10:00:00",
      "endTime": "2025-01-21 22:00:00",
      "id": "partner-sellingTimeID-1",
      "name": "Lunch deal",
      "serviceHours": {
        "mon": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "tue": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "wed": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "thu": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "fri": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "sat": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "sun": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        }
      }
    }
  ],
  "categories": [
    {
      "id": "category_id",
      "name": "Value set",
      "nameTranslation": {
        "property1": "translation",
        "property2": "translation"
      },
      "availableStatus": "AVAILABLE",
      "sellingTimeID": "partner-sellingTimeID-1",
      "sequence": 1,
      "items": [
        {
          "id": "item_id",
          "name": "Crispy burger with smoked salmon",
          "nameTranslation": {
            "property1": "translation",
            "property2": "translation"
          },
          "availableStatus": "AVAILABLE",
          "description": "Crispy burger with smoked salmon is a delicious twist on a classic burger. Made with a perfectly cooked beef patty and topped with smoked salmon, fresh greens, and a creamy sauce.",
          "descriptionTranslation": {
            "property1": "translation",
            "property2": "translation"
          },
          "price": 1900,
          "photos": [
            "http://example.com/image_url.jpg"
          ],
          "specialType": null,
          "taxable": false,
          "barcode": "GTIN",
          "sellingTimeID": "partner-sellingTimeID-1",
          "maxStock": 15,
          "sequence": 1,
          "advancedPricing": {
            "Delivery_OnDemand_GrabApp": 30,
            "Delivery_Scheduled_GrabApp": 25,
            "SelfPickUp_OnDemand_GrabApp": 25,
            "DineIn_OnDemand_GrabApp": 25,
            "Delivery_OnDemand_StoreFront": 25,
            "Delivery_Scheduled_StoreFront": 25,
            "SelfPickUp_OnDemand_StoreFront": 25
          },
          "purchasability": {
            "Delivery_OnDemand_GrabApp": true,
            "Delivery_Scheduled_GrabApp": true,
            "SelfPickUp_OnDemand_GrabApp": true,
            "DineIn_OnDemand_GrabApp": true,
            "Delivery_OnDemand_StoreFront": true,
            "Delivery_Scheduled_StoreFront": true,
            "SelfPickUp_OnDemand_StoreFront": true
          },
          "modifierGroups": [
            {
              "id": "modifier_group_id",
              "name": "Add on",
              "nameTranslation": {
                "property1": "translation",
                "property2": "translation"
              },
              "availableStatus": "AVAILABLE",
              "selectionRangeMin": 0,
              "selectionRangeMax": 1,
              "sequence": 1,
              "modifiers": [
                {
                  "id": "modifier_id",
                  "name": "Smoked tuna",
                  "nameTranslation": {},
                  "availableStatus": "AVAILABLE",
                  "price": 200,
                  "barcode": "GTIN",
                  "sequence": 1,
                  "advancedPricing": {}
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Copy

{
  "merchantID": "1-CYNGRUNGSBCCC",
  "partnerMerchantID": "Partner-ABECU",
  "currency": {
    "code": "SGD",
    "symbol": "S$",
    "exponent": 2
  },
  "sellingTimes": [
    {
      "startTime": "2022-03-01 10:00:00",
      "endTime": "2025-01-21 22:00:00",
      "id": "partner-sellingTimeID-1",
      "name": "Lunch deal",
      "serviceHours": {
        "mon": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "tue": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "wed": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "thu": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "fri": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "sat": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        },
        "sun": {
          "openPeriodType": "OpenPeriod",
          "periods": [
            {
              "startTime": "11:30",
              "endTime": "21:30"
            }
          ]
        }
      }
    }
  ],
  "categories": [
    {
      "id": "category_id",
      "name": "Value set",
      "nameTranslation": {
        "property1": "translation",
        "property2": "translation"
      },
      "availableStatus": "AVAILABLE",
      "sellingTimeID": "partner-sellingTimeID-1",
      "sequence": 1,
      "items": [
        {
          "id": "item_id",
          "name": "Crispy burger with smoked salmon",
          "nameTranslation": {
            "property1": "translation",
            "property2": "translation"
          },
          "availableStatus": "AVAILABLE",
          "description": "Crispy burger with smoked salmon is a delicious twist on a classic burger. Made with a perfectly cooked beef patty and topped with smoked salmon, fresh greens, and a creamy sauce.",
          "descriptionTranslation": {
            "property1": "translation",
            "property2": "translation"
          },
          "price": 1900,
          "photos": [
            "http://example.com/image_url.jpg"
          ],
          "specialType": null,
          "taxable": false,
          "barcode": "GTIN",
          "sellingTimeID": "partner-sellingTimeID-1",
          "maxStock": 15,
          "sequence": 1,
          "advancedPricing": {
            "Delivery_OnDemand_GrabApp": 30,
            "Delivery_Scheduled_GrabApp": 25,
            "SelfPickUp_OnDemand_GrabApp": 25,
            "DineIn_OnDemand_GrabApp": 25,
            "Delivery_OnDemand_StoreFront": 25,
            "Delivery_Scheduled_StoreFront": 25,
            "SelfPickUp_OnDemand_StoreFront": 25
          },
          "purchasability": {
            "Delivery_OnDemand_GrabApp": true,
            "Delivery_Scheduled_GrabApp": true,
            "SelfPickUp_OnDemand_GrabApp": true,
            "DineIn_OnDemand_GrabApp": true,
            "Delivery_OnDemand_StoreFront": true,
            "Delivery_Scheduled_StoreFront": true,
            "SelfPickUp_OnDemand_StoreFront": true
          },
          "modifierGroups": [
            {
              "id": "modifier_group_id",
              "name": "Add on",
              "nameTranslation": {
                "property1": "translation",
                "property2": "translation"
              },
              "availableStatus": "AVAILABLE",
              "selectionRangeMin": 0,
              "selectionRangeMax": 1,
              "sequence": 1,
              "modifiers": [
                {
                  "id": "modifier_id",
                  "name": "Smoked tuna",
                  "nameTranslation": {},
                  "availableStatus": "AVAILABLE",
                  "price": 200,
                  "barcode": "GTIN",
                  "sequence": 1,
                  "advancedPricing": {}
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Expand

MANAGE CAMPAIGN Copy Link

Create Campaign Copy Link

This Method is used to create campaigns for your merchant(s).

⚠️ Important:
▪️ The start Time has to be after the time of creating the campaign (current time).
▪️ Your campaign must have a minimum duration of 2 hours and maximum duration of 2 months.
▪️ GrabFood only supports campaign creation at the merchant level. You can only create a campaign for 1 merchant per request.
▪️ For an item level campaign, you can only have a maximum of 100 items.
▪️ You can only have a maximum of 100 active campaigns (ongoing and upcoming).
▪️ Only Dollar off campaign and Percentage Off campaign are available for testing in the staging environment as of now.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Create Campaign
Connection*	Select your connection or create one.
Map Fields [+ Add Field] Add extra fields: Quotas, Custom Tag.
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Name*	The campaign’s name.
Conditions*	The conditions to apply to a campaign. Start Time:The campaign’s start time in UTC format. For example, 2021-09-23T03:30:00Z means 2021-09-23 11:30:00 (UTC +08:00). End Time: The campaign’s end time in UTC format. Eater Type: Select “All” or “New” The type of eater eligible for the campaign: `all` – campaign will be applied to everyone. No limitation on campaign type. `new` – campaign will be applied to consumers who have not ordered from this store in the last three months. Only applicable to order-level* campaign. [+ Add Field] Add extra fields: Minimum Basket Amount: The minimum basket amount to be eligible for the campaign. Only applicable to order-level campaign but not to item-level discount campaign. Bundle Quantity: Specify the bundle quantity for bundle offer campaign. Working Hour: Define the working Hour for each day. [+ Add Field] Add days. Sunday Periods [⊕ Element][⊕ Map] Add more Periods or Map it from a Data Source (see Field Mapping). Start Time: The open start time in 24h format. Local time format is expected. End Time: The open end time in 24h format. Local time format is expected. Same settings for the other days: Monday – Tuesday – Wednesday – Thursday – Friday – Saturday
Discount*	The discount detail for a particular campaign when conditions are satisfied. Type: The type of discount Select: “Net” “Percentage” “Delivery” “Free Item” “Bundle Same Net” “Bundle Same Percentage” “Bundle Same Fix Price” “Bundle Diff Net” “Bundle Diff Percentage” “Bundle Diff Fix Price” Scope: The scope level for a particular campaign. Scope.Type: The scope type for this campaign. Select: – Order: order level campaign. – Items: item level campaign or bundle offer. – Category: category level campaign where all items within applies the same discount. [+ Add Field]* Add extra fields: Object IDs: The list of item IDs in the partner’s database applicable for discount when `discount.scope.type` is `items` (or category IDs for `category`). ▪️ One and only 1 item supported when `discount.type` is: `Free Item` `Bundle Same Net` `Bundle Same Percentage` `Bundle Same Fix Price` ▪️ Minimum 2 – Maximum 20 items supported when `discount.type` is: `Bundle Diff Net` `Bundle Diff Percentage` `Bundle Diff Fix Price` [+ Add Field] Add extra fields: Cap: The maximum discount dollar amount. can be applied to “Percentage” discount type. This will be ignored for others discount types. Value: Specify the discount amount. Decimal number is not supported For VN, ID and TH. For example, `10.5` is not allowed and it should be `10.0`. ▪️ Dollar amount value when `discount type` is `net`, `delivery`, `Bundle Same Net`, `Bundle Same Fix Price`, `Bundle Diff Net`, `Bundle Diff Fix Price`. ▪️ Percentage value (0-100) when `discount type` is `percentage`, `Bundle Same Percentage`, `Bundle Diff Percentage`. ▪️ Not required when the `discount type` is `Free Item`.
Quotas	Total Count: The maximum number of redemptions. Default is unlimited if unspecified. Total Count Per User: The maximum number of redemptions per user. Default is unlimited if unspecified.
Custom Tag	Specify the tag for custom bundle offer campaign. Only whitelisted partner is supported as of now. (<= 22 characters)

(*) required field

Delete Campaign Copy Link

This Method is used to to delete a campaign.
⚠️ Campaigns created by Grab team cannot be deleted via this Method.
▪️ Active orders with the applied campaign will not be affected.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Delete Campaign
Connection*	Select your connection or create one.
Matching Criteria
Campaign ID*	The campaign’s ID. You get get it from the Method “List” Campaign. E.g., “id”: “GFSBPOS-503-266-C65DV2BUJFVTE2-30093724”

(*) required field

List (campaign) Copy Link

This Method is used to retrieve restaurant’s ongoing and upcoming campaigns.
▪️ The Method only returns a maximum of 100 ongoing and 100 upcoming campaigns.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	List
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).

(*) required field

Update Campaign Copy Link

This Method is used to update upcoming campaigns only; it is not allowed for ongoing campaigns.

▪️ Update upcoming campaign is not allowed if the campaign start Time is within 1 hour.
▪️ Campaigns created by the merchant app and Grab team cannot be updated.

See more about this endpoint on Grab Developer documentation.

Configuration Table:

Input Options (Field Mapping):

Input: Allows dynamic inputs, e.g., from a Trigger or from Step responses. Input tab>uncheck “Show recommended” to see all fields).
Default Value: Select value from a defined list or specify a fixed attribute.
Manual input: Set a custom value by using the Lightning Bold feature.

Name*	Update Campaign
Connection*	Select your connection or create one.
Matching Criteria
Merchant ID*	Store ID in your Grab Developer Portal > GrabFood POS integration > Store information (Store overview for production environment, corresponding to Grab Store ID).
Campaign ID*	The campaign’s ID. You get get it from the Method “List” Campaign. E.g., “id”: “GFSBPOS-503-266-C65DV2BUJFVTE2-30093724”
Map Fields [+ Add Field] Add extra fields: Quotas, Custom Tag.
Name*	The campaign’s new name.
Conditions*	The conditions to apply to a campaign. Start Time:The campaign’s start time in UTC format. For example, 2021-09-23T03:30:00Z means 2021-09-23 11:30:00 (UTC +08:00). End Time: The campaign’s end time in UTC format. Eater Type: Select “All” or “New” The type of eater eligible for the campaign: `all` – campaign will be applied to everyone. No limitation on campaign type. `new` – campaign will be applied to consumers who have not ordered from this store in the last three months. Only applicable to order-level* campaign. [+ Add Field] Add extra fields: Minimum Basket Amount: The minimum basket amount to be eligible for the campaign. Only applicable to order-level campaign but not to item-level discount campaign. Bundle Quantity: Specify the bundle quantity for bundle offer campaign. Working Hour: Define the working Hour for each day. [+ Add Field] Add days. Sunday Periods [⊕ Element][⊕ Map] Add more Periods or Map it from a Data Source (see Field Mapping). Start Time: The open start time in 24h format. Local time format is expected. End Time: The open end time in 24h format. Local time format is expected. Same settings for the other days: Monday – Tuesday – Wednesday – Thursday – Friday – Saturday
Discount*	The discount detail for a particular campaign when conditions are satisfied. Type: The type of discount Select: “Net” “Percentage” “Delivery” “Free Item” “Bundle Same Net” “Bundle Same Percentage” “Bundle Same Fix Price” “Bundle Diff Net” “Bundle Diff Percentage” “Bundle Diff Fix Price” Scope: The scope level for a particular campaign. Scope.Type: The scope type for this campaign. Select: – Order: order level campaign. – Items: item level campaign or bundle offer. – Category: category level campaign where all items within applies the same discount. [+ Add Field]* Add extra fields: Object IDs: The list of item IDs in the partner’s database applicable for discount when `discount.scope.type` is `items` (or category IDs for `category`). ▪️ One and only 1 item supported when `discount.type` is: `Free Item` `Bundle Same Net` `Bundle Same Percentage` `Bundle Same Fix Price` ▪️ Minimum 2 – Maximum 20 items supported when `discount.type` is: `Bundle Diff Net` `Bundle Diff Percentage` `Bundle Diff Fix Price` [+ Add Field] Add extra fields: Cap: The maximum discount dollar amount. can be applied to “Percentage” discount type. This will be ignored for others discount types. Value: Specify the discount amount. Decimal number is not supported For VN, ID and TH. For example, `10.5` is not allowed and it should be `10.0`. ▪️ Dollar amount value when `discount type` is `net`, `delivery`, `Bundle Same Net`, `Bundle Same Fix Price`, `Bundle Diff Net`, `Bundle Diff Fix Price`. ▪️ Percentage value (0-100) when `discount type` is `percentage`, `Bundle Same Percentage`, `Bundle Diff Percentage`. ▪️ Not required when the `discount type` is `Free Item`.
Quotas	The quotas/limits for a particular campaign. Total Count: The maximum number of redemptions. Default is unlimited if unspecified. Total Count Per User: The maximum number of redemptions per user. Default is unlimited if unspecified.
Custom Tag	Specify the tag for custom bundle offer campaign. Only whitelisted partner is supported as of now. (<= 22 characters)

(*) required field

Test and automate your Flow Copy Link

Once your Flow is configured, you can test or automate it using the Run panel or by managing Triggers from the Flow Management screen.

Run Flow: Manually runs the Flow once using sample data. Ideal for testing logic and field mapping. See How to Run a Flow.
Run Scheduler: Force-runs the Trigger immediately using live input. This bypasses the recurrence rule and is useful for verifying real data mapping. Learn more in Wiresk Scheduler – The Fundamentals.

From the Trigger management panel (clock icon), you can:

Activate or deactivate Triggers
Force-run the scheduler
Copy Routing Keys (for HTTP Triggers)

If your Flow uses a Webhook Trigger, it runs automatically on each incoming webhook—no scheduler required. It remains active until you manually deactivate it.

GrabFood – Connection & Settings

Connect GrabFood to Wiresk Copy Link

Add GrabFood app in Wiresk Copy Link

Basic understanding of Flow creation Copy Link

GrabFood Methods Copy Link

MANAGE ITEM Copy Link

Update Item Copy Link

Update Item Modifier Copy Link

MANAGE ORDER Copy Link

List Copy Link

Accept Order Copy Link

Cancel Order Copy Link

Check Cancellation Eligibility Copy Link

Reject Order Copy Link

Set Order Ready Time Copy Link

Update Order Copy Link

Update Order Status Copy Link

Update Order as Ready Copy Link

MANAGE MENU Copy Link

Notify Menu Update Copy Link

MANAGE STORE Copy Link

Update Store Status Copy Link

MANAGE PARTNER ENDPOINT Copy Link

Get Partner Access Token Copy Link

Set Partner Menu Copy Link

MANAGE CAMPAIGN Copy Link

Create Campaign Copy Link

Delete Campaign Copy Link

List (campaign) Copy Link

Update Campaign Copy Link

Test and automate your Flow Copy Link