Release notes for the Grubhub POS services:
Subscribe here for new updates
MARCH 2023
Keeping 86ing schedules - Menu Ingestion
apply_existing_schedule_overrides - Boolean
This flag indicates whether or not to apply existing, valid schedule overrides on the new menu. The default value is false, so unless explicitly specified all existing schedule overrides will be cleared on a new menu ingestion.
JANUARY 2023
merchant_statuses
The Merchant Batch Operation Status now includes a new field under merchant statuses. Prior to this, our response returns our internal id when you check the status. The same id that was requested for the corresponding POST calls should now be returned in the response. At some point, merchant status will be deprecated.
September 2022
Deprecating Endpoint - Single Entity by GrubHub Internal Id
This endpoint is being deprecated (synchronous)
- PATCH /pos/v1/merchant/{merchant_long_id}/menu/items/{entity_id}/overrides
Please use the following two endpoints instead (click links for additional information):
Bulk Entities by GrubHub Internal Ids | Bulk Entities by Partner External Ids
- PATCH /pos/v1/merchant/{merchant_long_id}/menu/schedules/overrides
- PATCH /pos/v1/merchant/{merchant_long_id}/menu/schedules/overrides/external
With the latest release this operation will happen asynchronously. The return is a reference to the processing job which will run in the background. The reference (job_id) can later be used to check the status / progress of the operation. The initial status of each request is QUEUED, stating that the request was received and it will be processed soon.
August 2022
Grubhub announces the deprecation of the v1 Partner APIs
- Grubhub is deprecating the v1 Partner APIs, also known as the canonical API. While the deprecation date has not been finalized, Grubhub will not be making feature updates to these APIs going forward. Partners are encouraged to move to the GH v2 API in order to take advantage of the latest Grubhub integrations features. If you have any questions regarding building to the v2 API, please reach out to your GH integrations contacts or your Enterprise Partnerships Manager.
Batch Online/Offline for restaurants Endpoint Added
- Added an endpoint that provides the ability to set a batch of restaurants online/offline on Grubhub.
Batch Status Endpoint Added
- Added an endpoint that provides the ability return the status of the merchant online/offline batch together with the progress for each individual merchant, or, if present, only for the specified merchant ID.
April 2022
Rapid Onboarding
- Added an endpoint that provides the ability to set a restaurant online/offline on Grubhub. When offline, the restaurant will not be listed on the site; when online, the restaurant will be listed on the site and be able to accept orders.
Set Pre-Order Confirmation Window endpoint
- Added an endpoint to update the Pre-order Confirmable window. The Pre-order confirmable window determines when Grubhub should transition a scheduled order from ANTICIPATED status to RESTAURANT_CONFIRMABLE with relation to the desired fulfillment time.
March 2022
Rapid Onboarding
- Partner Webhook of Merchants configured for Integration
- Added an endpoint that lets partners toggle integration status for a batch of merchants. A merchant can have pos integration enabled as long as it has at least one successful menu ingestion and it's not a GH Direct merchant.
February 2022
Toggle scheduled ordering capability for a merchant
Added an endpoint to allow an individual merchant to opt in/out of scheduled ordering.
Bulk Menu Item Overrides by Internal/External IDs
Added an endpoint to bulk add or update the menu schedule override for a list of entities by their Partner external IDs. The entities can be of any type (ITEM or MODIFIER). Used to '86' a list of entities (items / modifiers).
Get Merchant Details by External ID
November 10th 2021
Normalized Menu
- Added article for Normalized Menu Endpoints
Menus
- Deprecated Full Menu endpoints in the Menus article
Grubhub Partner Integration V1
- Renamed "Provider Enablement" section to "Grubhub Partner Integration V1" and deprecated content
Grubhub Partner Integration V2
- Renamed "POS Integration" section to "Grubhub Partner Integration V2"