---
title: "Recommend budget and duration"
method: POST
path: "/ads-management/v1/campaign-recommendations"
---

# Recommend budget and duration

`POST /ads-management/v1/campaign-recommendations`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/campaign-recommendations`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `ad.campaign:read`

Returns non-binding daily budget and duration suggestions for the proposed campaign. campaignContext accepts every creatable objective (PLAYS, ENGAGEMENT, ROBUX_SPEND). targetUniverseId and targeting.audienceType influence the result; RETENTION and REACTIVATION get budget recommendations for that audience. targeting accepts only audienceType: ageGroups, countries, regions, and devices return 400 with reason UNSUPPORTED_VALUE.

## Request body

- CampaignRecommendationRequest
  - `campaignContext` PlanningCampaignContext, required
    - `objective` 'PLAYS' | 'ENGAGEMENT' | 'ROBUX_SPEND', required: The advertising goal. Can be `PLAYS`, `ENGAGEMENT`, or `ROBUX_SPEND`.
    - `targetUniverseId` string, required: The experience to plan for, as a decimal string.
    - `targeting` Targeting
      - `ageGroups` string[]: The age brackets to deliver to. Empty means all ages. Values can be `AGE_13_17`, `AGE_18_24`, or `AGE_25_PLUS`.
      - `audienceType` 'ALL_PLAYERS' | 'NEW_USERS' | 'RETENTION' | 'REACTIVATION': Omitted or `ALL_PLAYERS` delivers to all players. Other values restrict delivery to a retargeting audience of the target experience. For `ENGAGEMENT`, only omission or `ALL_PLAYERS` is accepted; other targeting fields are rejected. Responses always include the resolved value.
      - `countries` string[]: The ISO 3166-1 alpha-2 country codes to deliver to (for example, `US`). Empty means all countries. Use this field to target single countries. Can't be combined with the region `ALL`, or with the region that contains the country.
      - `devices` string[]: The device types to deliver to. Empty means all devices. Values can be `PHONE`, `TABLET`, `DESKTOP`, or `CONSOLE`.
      - `regions` string[]: The aggregate geographic regions to deliver to, or `ALL`. Empty means all regions. Use only the values in campaign-options `targetingDimensions.regions`. `ALL` can't be combined with other regions or with countries.

## Response `200`

OK

- CampaignRecommendationResponse
  - `budgetOptionsMicros` string[], required: A lower, the recommended, and a higher daily budget in micro-USD, as decimal strings in ascending order.
  - `budgetType` 'DAILY', required: Recommendations are always daily budgets.
  - `durationOptionsInDays` integer[], required: Suggested campaign lengths for a duration picker, in ascending order.
  - `recommendedBudgetMicros` string, required: The suggested daily budget in micro-USD, as a decimal string. Always one of budgetOptionsMicros.

## Other responses

- `400`: Invalid request
- `403`: Permission denied
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/campaign-recommendations/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/a94d3bd77d7f?raw)
