Hi Creators,
If you manage Roblox ad campaigns, you can now do it programmatically. The Ads Manager API is available on Open Cloud, so you can create campaigns, update them, and check whether they’re serving using an API key or OAuth2 without clicking through the dashboard for every change. It’s especially useful if you run many campaigns, want to build your own dashboards, connect advertising into the tools you already use, or point an AI agent at it to manage campaigns for you.
You can start testing this today, and we’ll keep refining the API based on your feedback before moving it to Beta and then Full Release.
Use the Ads Manager API to Manage Campaigns
The API covers the whole campaign lifecycle:
- Create and manage campaigns: create a campaign, update its name, budget, or schedule, and pause, resume, or cancel it.
- Track delivery: check whether one campaign or a batch of campaigns is serving, in review, or blocked, with reasons you can act on.
- Look things up: list your billing accounts, advertisable experiences, campaign options and eligibility, and your creative library.
How to Authenticate and Call the API
Authenticate with an API key (x-api-key) or OAuth2, using these scopes:
ad.campaign:read— read campaigns, status, and reference dataad.campaign:write— create and update campaignsad.billing:read— read billing accounts
Here’s how you create a campaign:
curl -X POST https://apis.roblox.com/ads-management/v1/campaigns \
-H "x-api-key: $API_KEY" \
-H "x-idempotency-key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Launch",
"objective": "ENGAGEMENT",
"paymentType": "ADS_CREDIT",
"targetUniverseId": "1234567890",
"creativeAssetIds": ["9988776655"],
"budget": { "type": "DAILY", "amountMicros": "50000000" },
"schedule": { "startTime": "2026-08-01T00:00:00Z", "durationInDays": 30 },
"targeting": { "countries": ["US"], "ageGroups": ["AGE_18_24"] }
}'
After you create a campaign, it starts in review. Poll campaigns:batchGetStatus until deliveryStatus is SERVING.
Getting Started
-
Create an API key in the Creator Hub and give it the scopes above.
-
Upload your creatives with the Open Cloud Assets API to get asset IDs.
-
Follow the create and status flow in the docs linked below.
Build Tools and AI Agents
This is a standard Open Cloud REST API with a published OpenAPI spec and a stable, versioned contract, which makes it easy to plug into the tools you already use, from custom dashboards to internal scripts. It’s also a natural fit for AI agents: you can expose these endpoints as tools to an LLM or agent framework and manage campaigns through natural-language workflows. You can create a campaign and check whether it’s serving without hand-writing each call. If you’re building agentic tooling around advertising, this API is a foundation to build on.
Known Issues
The API is experimental, so request and response shapes can change while we iterate. We don’t recommend relying on it for production-critical automation yet.
What’s Next
We’ll move the API from testing to Beta to Full Release as it settles, with a migration window once it reaches Beta. We’re also looking at richer targeting, support for all objectives, and creative management in future versions.
Campaign performance reporting isn’t part of this experimental launch. You’ll get it soon through the Analytics API — we’ll share more when that lands.
Resources
Please share any feedback with us below. Thank you!
FAQs
Do I need a paid account?
- You choose an existing funding method (paymentType) when you create a campaign. Adding cards or ad credits still happens in the Ads Manager dashboard.
Will the campaigns I create with the API show up in Ads Manager?
- Yes, it’s the same backend, so API-created campaigns appear in the dashboard, and changes made in either place stay in sync.
Are there rate limits?
- Yes, there are per-API-key limits. See the docs for per-endpoint details.
Can I use a group-owned API key?
- Not in this version — use a user-owned key.
