This page answers common questions about the Uber Ads API. If your question isn’t covered here, please reach out to our developer team.

¶ Authentication

¶ Do we need separate developer applications for the Eats API and the Ads API?

No. The same application can be used for both. Please reach out to our support team to have the scopes you need granted to that application.

¶ Is the client credentials grant supported?

No. We do not currently plan to support the client credentials authorization flow. If this is a requirement for your integration, please reach out to our developer team.

¶ Does the authentication method differ from the Promo API?

The two are largely the same. The key difference is that the Promo API requires an additional step to request access at the store level, on top of requesting access to the user. The Ads API does not require store-level authentication.

¶ Ad Accounts & Stores

¶ How are ad accounts set up, and how are stores linked to an account?

It depends on the type of ad account:

• Traditional ad account (common for enterprise merchants): The stores linked to the account are selected during account setup. Merchants request these changes through their Account Manager.
• Store group ad account (common for SMB merchants who have not set up a traditional ad account): This account type is created automatically and links to every store the merchant can access in Uber Eats Manager. To gain access to additional stores, merchants contact Uber support or their Account Representative.

¶ Is there one ad account per advertiser, or is it split by brand or marketplace?

An advertiser can have multiple ad accounts. How those accounts are divided—for example, by brand or by marketplace—is left to the advertiser’s discretion.

¶ Can a single store be linked to more than one ad account?

Yes. While one ad account can be linked to many stores, a single store can also be linked to multiple ad accounts, including multiple traditional ad accounts and multiple store group ad accounts.

¶ Can an ad account use more than one currency?

No. Each ad account has a single currency. Validation prevents creating campaigns whose budget currency differs from the ad account’s currency.

¶ Can more than one technology partner use the API for the same store?

Technically, more than one technology partner can use the API for the same store at the same time. However, this is at the merchant’s discretion, and we advise against it because multiple partners managing the same store can lead to confusion.

¶ Can we retrieve campaigns that weren’t created through our integration?

Yes. As long as the merchant has added the email or username they use with your platform to every store in Uber Eats Manager and to every ad account that has ads or offer campaigns running, those campaigns will be visible to your integration.

¶ For a given store, can we retrieve campaigns across all sources and ad accounts?

Yes—for example, campaigns from Uber Eats Manager and from multiple Ads Manager accounts. The merchant must first add the email or username they use with your platform to all of the relevant stores in Uber Eats Manager and to all of the relevant ad accounts. Once that access is granted, you can retrieve reporting across all of those stores and ad accounts.

¶ Campaign Management

¶ Are there limits on the number of ad groups and ads?

Yes. A campaign can contain at most 50 ad groups, and each ad group can contain at most 20 ads.

¶ Is pricing based on a first-price or second-price auction?

Uber Ads uses a second-price auction.

¶ How is the timezone determined?

The APIs are generally timezone-agnostic. Where a timezone is relevant—such as budget enforcement—the ad account’s local timezone is used.

¶ Do campaigns have start and end dates (a schedule)?

No. A schedule is defined only at the ad group level for now, not at the campaign level.

¶ What do effective status values mean, and how does a campaign get its effective status?

Effective status conveys the deliverability of a campaign—whether it is actually able to serve. It is derived from the configured statuses of the campaign and of its ad groups and ads. For example, a campaign that is configured as active will still have an effective status of paused if all of its ad groups are configured as paused.

¶ What is the auto-resume date on an ad group action?

The resume_date field (actions → AdGroupAction → AutoResumeAction → resume_date) controls whether an ad group is automatically resumed after a given date. This is configurable in Uber’s own UIs, but we do not plan to support it through the external API.

¶ Will the API support creating and pushing creatives to ad campaigns?

Custom creatives will not be available at the initial launch (February 2026). We plan to add this capability in a later release.

¶ Budgets & Pacing

¶ How does a daily budget (BUDGET_UNIT_DAILY) behave?

A daily budget is enforced per calendar day based on the ad account’s local timezone. The system aims to spend that budget each day; it does not even out spend across the week (evening out applies only to weekly and fixed budgets).

¶ How is a week defined for a weekly budget (BUDGET_UNIT_WEEKLY)?

A week runs from Monday 12:00:00 AM to Sunday 11:59:59 PM and resets every Monday at 12:00 AM. This definition is the same inside and outside the US.

¶ How does pacing work for a partial first week?

Spend is planned around expected order-volume fluctuations throughout the week and is prorated. For example, if a campaign with a $100 weekly budget is activated on a Wednesday, we plan and attempt to spend only the portion of the weekly budget that would have been allocated from Wednesday through Sunday (roughly $75 in this example), rather than spending the full weekly budget across the remaining days.

¶ Reporting

¶ What is the data freshness for the reporting APIs?

For most reports, data is refreshed approximately every 10 minutes.

¶ What is the SLA for daily data availability?

Reports should generally be available within a day, and in most cases within a few minutes of being requested.

¶ What does total_sales_local mean in the reporting API?

total_sales_local is expressed in the currency of the ad account (its currency code).

¶ Rate Limits

¶ What are the API rate limits?

Limits vary by endpoint and are applied per user, per ad account, and per integrator. Rate limits are subject to change; see Rate Limiting for the current limits and for what happens when you exceed one.