Skip to main content
PUT
/
campaigns
/
{campaignId}
Update campaign
curl --request PUT \
  --url https://api.agentic.scope3.com/api/v2/buyer/campaigns/{campaignId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "campaign": {
    "campaignId": "cmp_987654321",
    "advertiserId": "12345",
    "name": "Summer 2025 Campaign",
    "status": "DRAFT",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-20T14:45:00Z",
    "brief": "<string>",
    "flightDates": {
      "startDate": "2025-01-15T00:00:00Z",
      "endDate": "2025-03-31T23:59:59Z"
    },
    "budget": {
      "total": 1,
      "currency": "USD",
      "dailyCap": 1,
      "pacing": "EVEN"
    },
    "constraints": {
      "channels": [
        "<string>"
      ],
      "countries": [
        "<string>"
      ]
    },
    "performanceConfig": {
      "optimizationGoal": {
        "eventSourceId": "es_abc123",
        "eventType": "page_view",
        "targetRoas": 4,
        "targetCpa": 25,
        "attributionWindow": {
          "clickThrough": "7d",
          "viewThrough": "1d"
        }
      }
    },
    "productCount": 15
  }
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

id
string
required

Unique identifier for the campaign

Minimum string length: 1
Example:

"cmp_987654321"

Body

application/json

Request body for updating a campaign

name
string

Updated campaign name

Required string length: 1 - 255
flightDates
object

Updated campaign flight dates

budget
object

Updated budget configuration (partial updates allowed)

brief
string

Updated campaign brief

Maximum string length: 5000
constraints
object

Updated targeting constraints

bundleId
string

Attach a bundle to the campaign

Minimum string length: 1
performanceConfig
object

Updated performance configuration

Response

Update campaign

Response containing a single campaign

campaign
object
required

Campaign resource representation