vGrubs Marketplace Integration

Connect your marketplace to vGrubs: receive orders, sync menus and stores, and track vDrive deliveries through one REST contract.

vGrubs is a unified delivery management platform that aggregates orders across multiple delivery providers. When your marketplace is connected as a partner, vGrubs handles order routing to merchants and keeps your system in sync by calling a set of well-defined endpoints that you implement.

This documentation defines the integration contract between vGrubs and marketplace partners. It is intended for the technical team responsible for implementing the integration on the partner side.

How the integration is structured

The contract has two directions. Endpoints marked "You call vGrubs" are hosted on the vGrubs sandbox and you call them from your backend - you can execute them directly from these docs with the Try It panel. Endpoints marked "vGrubs calls you" are webhooks you implement on your API; for those, the docs generate ready-to-run requests against your own base URL so you can test your implementation.

• Order Management - you push new orders and cancellations to vGrubs; vGrubs notifies you of status changes.
• Delivery - vGrubs pushes real-time vDrive delivery updates to you.
• Merchant Management - vGrubs validates merchants and manages store availability, working hours and closing days.
• Menu Management - vGrubs pushes full menus to you; you can request a fresh publish.
• Billing - you retrieve delivery, service fee and tax amounts for an order before charging the customer.

Conventions

• All monetary values are integers in cents (e.g. 3600 = $36.00).
• All timestamps are ISO 8601 strings (e.g. 2026-04-21T11:30:00.000Z).
• Phone numbers use E.164 format (e.g. +14155552671).
• Merchant-scoped times (scheduled orders, working hours, closing days) are in the merchant local timezone - see Get Merchant Timezone.

If you have any questions during the integration, reach out to your vGrubs integration contact.