---
title: "Create a performance estimate"
method: POST
path: "/ads-management/v1/performance-estimates"
---

# Create a performance estimate

`POST /ads-management/v1/performance-estimates`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/performance-estimates`
- 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`

Estimates an objective from a budget, or the budget required for a target outcome, for an experience the caller can advertise. Results are not cached.

## Request body

- PerformanceEstimateRequest
  - `campaignContext` PerformanceEstimateCampaignContext, required
    - `objective` 'PLAYS', required: The advertising goal. Only PLAYS is supported.
    - `targetUniverseId` string, required: The experience to estimate, as a decimal string.
  - `forecastInput` PerformanceEstimateForecastInput, required
    - `budget` PerformanceEstimateBudgetInput
      - `amountMicroUsd` string: Daily or lifetime total, matching forecastScope.budgetType, in micro-USD as a decimal string.
    - `targetOutcome` PerformanceEstimateTargetOutcome
      - `outcomeType` 'PLAYS': The outcome to reach. Only PLAYS is supported.
      - `value` integer: Daily or lifetime total, matching forecastScope.budgetType.
  - `forecastScope` PerformanceEstimateScope, required
    - `budgetType` 'DAILY' | 'LIFETIME', required: DAILY or LIFETIME.
    - `durationInDays` integer: Required and positive for LIFETIME. Must be 0 for DAILY.

## Response `200`

OK

- PerformanceEstimateResponse
  - `budget` PerformanceEstimateBudget
    - `dailyAmountMicroUsd` string: Daily budget in micro-USD, as a decimal string.
    - `dailyAmountMicroUsdRange` PerformanceEstimateMoneyRange
      - `lowerBound` string: Inclusive lower bound in micro-USD, as a decimal string.
      - `upperBound` string: Inclusive upper bound in micro-USD, as a decimal string.
    - `lifetimeAmountMicroUsd` string: Lifetime budget in micro-USD, as a decimal string. Omitted for a daily budget.
    - `lifetimeAmountMicroUsdRange` PerformanceEstimateMoneyRange
      - `lowerBound` string: Inclusive lower bound in micro-USD, as a decimal string.
      - `upperBound` string: Inclusive upper bound in micro-USD, as a decimal string.
  - `derivedMetrics` PerformanceEstimateDerivedMetrics
    - `costPerOutcomeMicroUsd` string: Cost per outcome in micro-USD, as a decimal string.
    - `costPerOutcomeMicroUsdRange` PerformanceEstimateMoneyRange
      - `lowerBound` string: Inclusive lower bound in micro-USD, as a decimal string.
      - `upperBound` string: Inclusive upper bound in micro-USD, as a decimal string.
  - `outcome` PerformanceEstimateOutcome
    - `dailyValue` integer: Daily outcome.
    - `dailyValueRange` PerformanceEstimateValueRange
      - `lowerBound` integer: Inclusive lower bound.
      - `upperBound` integer: Inclusive upper bound.
    - `lifetimeValue` integer: Lifetime outcome. Omitted for a daily budget.
    - `lifetimeValueRange` PerformanceEstimateValueRange
      - `lowerBound` integer: Inclusive lower bound.
      - `upperBound` integer: Inclusive upper bound.
    - `outcomeType` 'PLAYS': The outcome measured. Always PLAYS.
  - `predicted` 'OUTCOME' | 'BUDGET': Which side was calculated: OUTCOME from a budget, or BUDGET from a target outcome.

## Other responses

- `400`: Invalid request
- `403`: Permission denied
- `404`: Not available
- `500`: Internal server error
- `504`: Timed out

## Changes

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

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/performance-estimates/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)
