---
title: "Validate a campaign without creating it"
method: POST
path: "/ads-management/v1/campaigns:validate"
---

# Validate a campaign without creating it

`POST /ads-management/v1/campaigns:validate`

## Request

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

Runs the same validation, permission, eligibility, and billing-account resolution as CreateCampaign, without creating anything. HTTP 200 means validation ran; read valid and errors, which match the errors CreateCampaign would return for the same body. resolvedBillingAccountId is the account the campaign would be created in. Malformed JSON, account-resolution failures, and dependency failures return the usual error envelope. Takes no x-idempotency-key.

## Request body

- CreateCampaignRequest
  - `autoReloadAdCreditEnabled` boolean: Whether ad credit is reloaded automatically when it runs low. Defaults to false.
  - `billingAccountId` string: The billing account to create the campaign in: your own, or one owned by a group where you have advertising permission. Optional; defaults to your own account, also for a group-owned experience. To pay with the group's ad credit, pass the group's account from campaign-options `billingAccounts`. For a group's account, targetUniverseId must be an experience the group owns.
  - `budget` Budget, required
    - `amountMicros` string, required: The budget amount in micro-USD, as a decimal string (for example, `5000000` = $5.00). Money is sent and returned as a string so large values keep full precision in every client. On a request it must be a numeric string of micro-USD. For ADS_CREDIT, the daily budget must not exceed the available ad credit balance after unbilled spend. For LIFETIME, compare amountMicros divided by the number of campaign days with that balance. maximumDailyBudgetMicros does not limit ADS_CREDIT or INVOICE campaigns.
    - `scheduledAmountMicros` string: The queued lower budget for a pending decrease, in micro-USD as a decimal string (same format as amountMicros). A budget increase takes effect immediately, but a decrease on a running campaign is applied at the next midnight in the account's time zone; until then the campaign keeps serving on amountMicros (the current, higher budget). Omitted when no decrease is pending.
    - `scheduledEffectiveTime` string, date-time: The time a pending budget decrease takes effect, as an RFC 3339 UTC timestamp. Omitted when no decrease is pending.
    - `type` 'DAILY' | 'LIFETIME', required: The budget cadence. Fixed when the campaign is created. Can be `DAILY` or `LIFETIME`.
  - `creativeAssetIds` string[], required: The Open Cloud image asset IDs to advertise, as decimal strings. Required. The assets must already exist and be usable by the caller. These are Roblox asset IDs, the same values as Creative.assetId.
  - `name` string, required: The display name of the campaign. Required.
  - `objective` 'PLAYS' | 'ENGAGEMENT' | 'ROBUX_SPEND', required: The advertising goal. Required. Can be `PLAYS`, `ENGAGEMENT`, or `ROBUX_SPEND`. `ENGAGEMENT` does not support targeting; `ENGAGEMENT` and `ROBUX_SPEND` are not available for every experience.
  - `paymentType` 'CREDIT_CARD' | 'ADS_CREDIT' | 'INVOICE', required: How the campaign is paid for. Required. Can be `CREDIT_CARD`, `ADS_CREDIT`, or `INVOICE`, subject to what the billing account supports. A group's billing account accepts only `ADS_CREDIT`.
  - `schedule` Schedule, required
    - `durationInDays` integer, required: How long the campaign runs from startTime, in days. Must not exceed 3650 (about 10 years). Zero means the campaign has no end date and runs until you pause or cancel it; endTime is then omitted. A LIFETIME budget needs an end date, so it needs a positive value.
    - `endTime` string, date-time: The instant the campaign stops, as an RFC 3339 UTC timestamp (read-only): one second before local midnight at the end of day durationInDays in the account's time zone. Not accepted on requests; supplying it returns 400. Use durationInDays to set when the campaign ends.
    - `startTime` string, date-time, required: The time the campaign starts serving, as an RFC 3339 timestamp. UTC (`Z`) is recommended. On a create request it must not be in the past.
  - `targetUniverseId` string, required: The identifier of the experience to advertise. Required.
  - `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.
  - `video` CampaignVideo
    - `previewVideoAssetId` string: When source is `PREVIEW_VIDEO`, the experience's current preview video asset ID, as a decimal string (read-only). Omitted when the experience has no eligible preview video, in which case the tile shows the image creative. Also omitted when sponsored video tiles aren't enabled for the campaign's billing account.
    - `source` 'IMAGE_ONLY' | 'PREVIEW_VIDEO', required: The video shown on the sponsored tile. Values can be `IMAGE_ONLY` or `PREVIEW_VIDEO`.

## Response `200`

Validation ran

- ValidateCampaignResponse
  - `errors` PublicError[], required: The errors CreateCampaign would return for this request, in the same order. Empty when valid.
    - `actionUrl` string, uri: Ads Manager page that a human opens to fix this error. Show this URL to the user and check again after they say they are done. Never collect payment details through the API or in chat.
    - `code` string, required: A stable, machine-readable error code (for example, `INVALID_ARGUMENT`, `NOT_FOUND`, `PERMISSION_DENIED`, or `RATE_LIMITED`).
    - `field` string: Request field path, when the error is tied to a specific field.
    - `message` string, required: A human-readable description of the error.
    - `reason` string: Specific machine-readable sub-reason, when applicable.
    - `remediation` string: Actionable guidance for resolving the error.
    - `retryable` boolean: Whether the caller should retry the request.
  - `resolvedBillingAccountId` string: The billing account the campaign would be created in.
  - `valid` boolean, required: Whether CreateCampaign would accept this request.
  - `warnings` Reason[], required: Non-blocking notes about the request.
    - `code` string, required: A stable, machine-readable code.
    - `message` string, required: A human-readable explanation.
    - `remediation` string: What the caller can do to resolve it.
    - `resource` string: The related resource, for example `billing-accounts/123`.

## Other responses

- `400`: Malformed request body
- `403`: Cannot resolve a billing account for this context
- `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/campaigns:validate/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)
