2 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

internal_public_v1.CreateCampaignRequest — openapi

Properties

NameTypeRequiredDescription
bidfalseOptional bidding strategy. Only AUTOMATED is accepted in v1; may be omitted.
budget#/components/schemas/internal_public_v1.Budgettrue
creativeAssetIdsarraytrueThe Open Cloud image asset IDs to advertise, as decimal strings. Required. The assets must already exist and be usable by the caller.
namestringtrueThe display name of the campaign. Required.
objectivestringtrueThe advertising goal. Required. Can be PLAYS (the deprecated ENGAGEMENT is also accepted during the transition; both create the same campaign).
paymentTypestringtrueHow the campaign is paid for. Required. Can be CREDIT_CARD, ADS_CREDIT, or INVOICE, subject to what the billing account supports.
schedule#/components/schemas/internal_public_v1.Scheduletrue
targetUniverseIdstringtrueThe identifier of the experience to advertise. Required.
targetingfalseOptional audience targeting. Omit it, or send an empty object, to reach all audiences.

Complete Schema

{
  "type": "object",
  "required": [
    "budget",
    "creativeAssetIds",
    "name",
    "objective",
    "paymentType",
    "schedule",
    "targetUniverseId"
  ],
  "properties": {
    "bid": {
      "description": "Optional bidding strategy. Only `AUTOMATED` is accepted in v1; may be omitted.",
      "allOf": [
        {
          "$ref": "#/components/schemas/internal_public_v1.Bid"
        }
      ]
    },
    "budget": {
      "$ref": "#/components/schemas/internal_public_v1.Budget"
    },
    "creativeAssetIds": {
      "description": "The Open Cloud image asset IDs to advertise, as decimal strings. Required. The\nassets must already exist and be usable by the caller.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "name": {
      "description": "The display name of the campaign. Required.",
      "type": "string"
    },
    "objective": {
      "description": "The advertising goal. Required. Can be `PLAYS` (the deprecated `ENGAGEMENT`\nis also accepted during the transition; both create the same campaign).",
      "type": "string",
      "enum": [
        "PLAYS",
        "ENGAGEMENT"
      ]
    },
    "paymentType": {
      "description": "How the campaign is paid for. Required. Can be `CREDIT_CARD`, `ADS_CREDIT`, or\n`INVOICE`, subject to what the billing account supports.",
      "type": "string",
      "enum": [
        "CREDIT_CARD",
        "ADS_CREDIT",
        "INVOICE"
      ]
    },
    "schedule": {
      "$ref": "#/components/schemas/internal_public_v1.Schedule"
    },
    "targetUniverseId": {
      "description": "The identifier of the experience to advertise. Required.",
      "type": "string"
    },
    "targeting": {
      "description": "Optional audience targeting. Omit it, or send an empty object, to reach all audiences.",
      "allOf": [
        {
          "$ref": "#/components/schemas/internal_public_v1.Targeting"
        }
      ]
    }
  }
}