Three lines



Integration Activation Flows

Access to These APIs May Require Written Approval From Uber

Uber’s APIs are always under development and as such are subject to changes according to our Versioning & Upgrade policy. As part of Uber’s ongoing privacy improvements, we’ve updated our Developer API program with new scope access policies for third party applications. For further information, please refer to our Getting Started guides.


Uber Eats provides merchants with multiple mechanisms for activating and configuring their live production stores against a given app integration.

  1. During onboarding, Uber may pre-integrate a store with integrator mapping details.
  2. Once live, the merchant should contact Uber technical support teams through our Tech Support Form
  3. Through an integration partner’s own website, by merchant’s authorizing you app with OAuth login flow, allowing you to call the GET /stores and POST /pos_data endpoints. See details below.

In each case, apps will be be notified of any initial and subsequent changes to their store integration status via the store.provisioned webhook. To provide a cohesive merchant experience, you should listen and respond to these webhooks. This is especially important if your app is responsible for core order workflow management (accepting; rejecting; or cancelling orders) as you may be requested to do follow-up actions (e.g. upload a menu).

If the integration details are wrong, or your integration is unable to operate the store, you should modify or deactivate the integration via PATCH /pos_data. Should your app ever be deactivated from a store, you will receive a store.deprovisioned webhook.

Once an app is activated against a given store, its client_credentials access token(s) will be able to call most APIs; and it will start to receive webhook notifications related to the store.

Using GET /pos_data; PATCH /pos_data; and POST /pos_data endpoints, integration partners can read and write their ID and configuration data against each store to facilitate mappings and debugging. For convenience, a subset of this integrator store data is also available when fetching or enumerating store details via the GET /stores endpoints.

Triggering Activation From 3rd Party Workflow
  • Authorization
    Developers can redirect users to Uber’s OAuth login flow, temporarily authorizing your app to access their stores.
  • Retrieve Stores
    Upon authorization, developer can retrieve all stores associated to the authorizing merchant via GET /stores. This call returns Uber’s unique identifier and store location data. Developer must map Uber’s unique ID to correct stores using the location data. External store ID can be arbitrary and should not be used as a sole matchpoint.
  • Activation
    Developers can activate their app against a store the POST /pos_data endpoint using the merchant user’s access token. This grants your app with perpetual access to the store.
  • Deactivating
    Developers can temporarily de-activate their app by setting integration_enabled to false with the PATCH /pos_data; or more permanently revoke integration by calling the DELETE /pos_data endpoints.
Merchant Authentication Workflow
Merchant's Web Browser Developer Web Server Uber API Authorized Scope(s): eats.pos_provisioning 1 GET HTTP 200 HTML POS Portal Microsite 2 Navigate Merchant Partner to "Login to UberEats" GET ?response_type=code&scope=eats.pos_provisioning&client_id={client_id}&redirect_uri={redirect_uri} HTTP 200 HTML Uber Eats Login Portal Merchant Completes Uber Login Flow HTTP 302 Redirect {redirect_uri}?code={SINGLE_USE_AUTHORIZATION_CODE} 3 GET {redirect_uri} ?code={SINGLE_USE_AUTHORIZATION_CODE} 4 POST ?code={SINGLE_USE_AUTHORIZATION_CODE}&… HTTP 200: {"access_token": "xxx", "token_type": "Bearer", …} Developer Site Portal POS Portal Microsite Developer Portal Merchant Authentication Merchant Access Token
Third-Party Activation Workflow
Merchant Developer Service Uber API Authorized Scope: eats.pos_provisioning GET (MERCHANT_ACCESS_TOKEN) HTTP 200: (stores: name;store_id;external_store_id;location{}) "Select Stores to Provision" POST{store_id}/pos_data (partner_store_id;store_configuration_data;pos_integration_enabled;) HTTP 200 NO CONTENT "Select Stores to De-provision" DELETE{store_id}/pos_data HTTP 200 NO CONTENT Retrieve Stores Associated to Merchant User Provision Selected Store IDs De-provision Selected Store IDs

My token is not authorized for endpoints?

The user access token (authorization_code grant type) is active for endpoints below:

Once a store is provisioned to a developer account via POST /pos_data, the developer will have access to the store using developer generated access token (client_credentials grant type). Developers should only use the user generated token when retrieving, provisioning or de-provisioning a merchant location.

Merchant is ready to provision the location but not ready to go live in the marketplace?

The Set Restaurant Status endpoint will enable you to pause the location so it does not appear within the Uber Eats marketplace. When the location is ready to launch, set restaurant status to ONLINE.

Next Steps

Review the Store Integration guide.


© 2023 Uber Technologies Inc.