Complete Grubhub's partner onboarding process to receive pre-production credentials and a test store; the API is partner-gated.
Subscribe to Grubhub order webhook events; when a customer places an order, Grubhub POSTs the order payload to your registered endpoint.
Respond with HTTP 200 immediately to acknowledge receipt, then asynchronously process the order.
Call the order confirmation endpoint with the estimated preparation time to accept the order; failing to confirm within the allowed window results in auto-cancellation.
Update the order status through the defined lifecycle states (e.g., preparing, ready for pickup) using the appropriate status update API calls.
For rejections, call the deny endpoint with a reason code; Grubhub surfaces this to the customer.
Known gotchas
Grubhub's Order Taking API requires explicit confirmation within a strict time window after receiving the webhook — missing this window triggers an automatic order cancellation and a negative signal on your integration health metrics.
Grubhub's developer portal access and production credentials are only issued after a formal review; plan for onboarding lead time before you can process live orders.
Order payloads include Grubhub-specific item and modifier IDs that must be mapped to your POS items — keep the menu mapping current whenever menus are updated on either side.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp