ROroblox
Advertising

List campaigns

Changed on

Lists the campaigns in the caller's billing account. Campaigns are grouped by status (ACTIVE first, then PAUSED, then CANCELLED) and returned newest first within each group. Results are paginated with a cursor (pageToken); each page returns up to maxPageSize campaigns (default 50, max 100).

get/ads-management/v1/campaigns

Request

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

Query parameters

maxPageSizeinteger

Maximum results per page (1-100, default 50)

pageTokenstring

Opaque cursor from a prior nextPageToken

Response

OK

nextPageTokenstring

The cursor for the next page. Pass it as pageToken to fetch the next page. Absent on the last page.

Changes

  • 1454b4b32362Revision changes
    • warning

      added the new ENGAGEMENT enum value to the // response property for the response status

    • info

      removed the ENGAGED_PLAYS enum value from the // response property for the response status

  • 85e5f0ce799dRevision changes
    • warning

      added the new AWARENESS enum value to the // response property for the response status

    • warning

      added the new ENGAGED_PLAYS enum value to the // response property for the response status

    • warning

      added the new PLAYS enum value to the // response property for the response status

    • warning

      added the new REACH enum value to the // response property for the response status

    • warning

      added the new ROBUX_SPEND enum value to the // response property for the response status

    • warning

      added the new VIDEO_VIEWS enum value to the // response property for the response status

    • info

      removed the ENGAGEMENT enum value from the // response property for the response status