Create bulk job
Loading server catalog…. Download catalog
POST
https://app.advarde.com/mcpUpstream account eligibility and feature access may also apply.
Description: Prepare a reviewable change: ads create bulk job. Returns a change_id; call ads_apply_change to execute after approval. Some features need Ads account enablement.
Method: tools/call · ads_create_bulk_job
Output: Tool data is returned in result.structuredContent and as JSON text in result.content. Inspect result.isError before using the result. Individual output fields depend on the operation.
Access: Requires the applicable write scopes, workspace role, and account permissions.
Upstream operation: POST /bulk_mutation_jobs. Call this through the MCP tool above.
Review before applying
This tool prepares a proposal. Review the exact payload and obtain authorization before calling ads_apply_change. Preparation does not mean the upstream change has been applied.
Authentication
Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.
For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.
Tool arguments
Send these fields inside params.arguments. The tool name is sent as params.name.
account_idstringrequiredformat:
"uuid"bodyobjectrequiredadditionalProperties:
falseEXPAND BODY
validate_onlybooleanoptionalpartial_failurebooleanoptionaloperationsarrayrequiredminItems:
1maxItems: 1000EXPAND OPERATIONS
Each array item
oneOf · schema 1
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"campaign.create"idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringoptionalpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
namestringrequiredminLength:
3maxLength: 1000pattern: ".*\\S.*"max_budget_microsintegerrequiredminimum:
1000000maximum: 9007199254740991billing_event_typeenumoptionalenum:
["click","impression"]budget_typeenumoptionalenum:
["lifetime","daily"]statusenumoptionalenum:
["active","paused"]target_countriesarrayoptionalEXPAND TARGET_COUNTRIES
Each array item
{
"type": "string",
"pattern": "^[A-Z]{2}$"
}location_idsarrayoptionalmaxItems:
2500EXPAND LOCATION_IDS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
}{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "campaign.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"max_budget_micros": {
"type": "integer",
"minimum": 1000000,
"maximum": 9007199254740991
},
"billing_event_type": {
"enum": [
"click",
"impression"
]
},
"budget_type": {
"enum": [
"lifetime",
"daily"
]
},
"status": {
"enum": [
"active",
"paused"
]
},
"target_countries": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"location_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
},
"maxItems": 2500
}
},
"required": [
"name",
"max_budget_micros"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
}oneOf · schema 2
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"campaign.update"idempotency_keystringoptionalminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringrequiredpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
namestringoptionalminLength:
3maxLength: 1000pattern: ".*\\S.*"descriptionstring | nulloptionalmaxLength:
5000statusenumoptionalenum:
["active","paused","archived"]max_budget_microsintegeroptionalminimum:
1000000maximum: 9007199254740991budget_typeenumoptionalenum:
["lifetime","daily"]start_timeinteger | nulloptionalminimum:
946684800maximum: 4102444800end_timeinteger | nulloptionalminimum:
946684800maximum: 4102444800location_idsarrayoptionalmaxItems:
2500EXPAND LOCATION_IDS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
}{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "campaign.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 5000
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"max_budget_micros": {
"type": "integer",
"minimum": 1000000,
"maximum": 9007199254740991
},
"budget_type": {
"enum": [
"lifetime",
"daily"
]
},
"start_time": {
"type": [
"integer",
"null"
],
"minimum": 946684800,
"maximum": 4102444800
},
"end_time": {
"type": [
"integer",
"null"
],
"minimum": 946684800,
"maximum": 4102444800
},
"location_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
},
"maxItems": 2500
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
}oneOf · schema 3
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"ad_group.create"idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringoptionalpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
campaign_idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"namestringrequiredminLength:
3maxLength: 1000pattern: ".*\\S.*"context_hintsarrayoptionalmaxItems:
2000EXPAND CONTEXT_HINTS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
}exclusion_hintsarrayoptionalmaxItems:
2000EXPAND EXCLUSION_HINTS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
}max_bid_microsintegeroptionalminimum:
1maximum: 9007199254740991max_cpm_bid_microsintegeroptionalminimum:
1maximum: 9007199254740991statusenumoptionalenum:
["active","paused"]{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad_group.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"campaign_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"context_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"exclusion_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"max_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_cpm_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"status": {
"enum": [
"active",
"paused"
]
}
},
"required": [
"campaign_idempotency_key",
"name"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
}oneOf · schema 4
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"ad_group.update"idempotency_keystringoptionalminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringrequiredpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
namestringoptionalminLength:
3maxLength: 1000pattern: ".*\\S.*"descriptionstring | nulloptionalmaxLength:
5000statusenumoptionalenum:
["active","paused","archived"]context_hintsarrayoptionalmaxItems:
2000EXPAND CONTEXT_HINTS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
}exclusion_hintsarrayoptionalmaxItems:
2000EXPAND EXCLUSION_HINTS
Each array item
{
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
}max_bid_microsintegeroptionalminimum:
1maximum: 9007199254740991max_cpm_bid_microsintegeroptionalminimum:
1maximum: 9007199254740991{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad_group.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 5000
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"context_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"exclusion_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"max_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_cpm_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
}oneOf · schema 5
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"ad.create"idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringoptionalpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
campaign_idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"ad_group_idempotency_keystringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"titlestringrequiredminLength:
3maxLength: 50pattern: ".*\\S.*"bodystringrequiredmaxLength:
100target_urlstringrequiredformat:
"uri"maxLength: 2048source_image_urlstringrequiredformat:
"uri"maxLength: 2048statusenumoptionalenum:
["active","paused"]{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"campaign_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"ad_group_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"title": {
"type": "string",
"minLength": 3,
"maxLength": 50,
"pattern": ".*\\S.*"
},
"body": {
"type": "string",
"maxLength": 100
},
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"source_image_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"status": {
"enum": [
"active",
"paused"
]
}
},
"required": [
"campaign_idempotency_key",
"ad_group_idempotency_key",
"title",
"body",
"target_url",
"source_image_url"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
}oneOf · schema 6
operation_idstringrequiredminLength:
1maxLength: 255pattern: ".*\\S.*"typeschemarequiredconst:
"ad.update"idempotency_keystringoptionalminLength:
1maxLength: 255pattern: ".*\\S.*"target_resource_idstringrequiredpattern:
"^[A-Za-z0-9_-]{1,255}$"inputobjectrequiredadditionalProperties:
falseEXPAND INPUT
namestringoptionalminLength:
3maxLength: 1000pattern: ".*\\S.*"statusenumoptionalenum:
["active","paused","archived"]creativeobjectoptionaladditionalProperties:
falseEXPAND CREATIVE
titlestringoptionalminLength:
3maxLength: 50pattern: ".*\\S.*"bodystringoptionalmaxLength:
100target_urlstringoptionalformat:
"uri"maxLength: 2048file_idstringoptionalminLength:
1maxLength: 255pattern: ".*\\S.*"{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"creative": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 50,
"pattern": ".*\\S.*"
},
"body": {
"type": "string",
"maxLength": 100
},
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"file_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
}
},
"required": [],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
}Full JSON Schema
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"format": "uuid"
},
"body": {
"type": "object",
"properties": {
"validate_only": {
"type": "boolean"
},
"partial_failure": {
"type": "boolean"
},
"operations": {
"type": "array",
"minItems": 1,
"maxItems": 1000,
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "campaign.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"max_budget_micros": {
"type": "integer",
"minimum": 1000000,
"maximum": 9007199254740991
},
"billing_event_type": {
"enum": [
"click",
"impression"
]
},
"budget_type": {
"enum": [
"lifetime",
"daily"
]
},
"status": {
"enum": [
"active",
"paused"
]
},
"target_countries": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
},
"location_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
},
"maxItems": 2500
}
},
"required": [
"name",
"max_budget_micros"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
},
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "campaign.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 5000
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"max_budget_micros": {
"type": "integer",
"minimum": 1000000,
"maximum": 9007199254740991
},
"budget_type": {
"enum": [
"lifetime",
"daily"
]
},
"start_time": {
"type": [
"integer",
"null"
],
"minimum": 946684800,
"maximum": 4102444800
},
"end_time": {
"type": [
"integer",
"null"
],
"minimum": 946684800,
"maximum": 4102444800
},
"location_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": ".*\\S.*"
},
"maxItems": 2500
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
},
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad_group.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"campaign_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"context_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"exclusion_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"max_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_cpm_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"status": {
"enum": [
"active",
"paused"
]
}
},
"required": [
"campaign_idempotency_key",
"name"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
},
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad_group.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 5000
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"context_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"exclusion_hints": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"maxItems": 2000
},
"max_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"max_cpm_bid_micros": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
},
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad.create"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"campaign_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"ad_group_idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"title": {
"type": "string",
"minLength": 3,
"maxLength": 50,
"pattern": ".*\\S.*"
},
"body": {
"type": "string",
"maxLength": 100
},
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"source_image_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"status": {
"enum": [
"active",
"paused"
]
}
},
"required": [
"campaign_idempotency_key",
"ad_group_idempotency_key",
"title",
"body",
"target_url",
"source_image_url"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"operation_id",
"type",
"input",
"idempotency_key"
],
"additionalProperties": false,
"minProperties": 0
},
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"type": {
"const": "ad.update"
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
},
"target_resource_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,255}$"
},
"input": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 1000,
"pattern": ".*\\S.*"
},
"status": {
"enum": [
"active",
"paused",
"archived"
]
},
"creative": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 50,
"pattern": ".*\\S.*"
},
"body": {
"type": "string",
"maxLength": 100
},
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"file_id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": ".*\\S.*"
}
},
"required": [],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}
},
"required": [
"operation_id",
"type",
"input",
"target_resource_id"
],
"additionalProperties": false,
"minProperties": 0
}
]
}
}
},
"required": [
"operations"
],
"additionalProperties": false,
"minProperties": 0
}
},
"required": [
"account_id",
"body"
],
"additionalProperties": false
}Responses
200Successful protocol response
Inspect result.isError for tool-level failures, even when the HTTP status is 200.
202Notification accepted
MCP notifications return no JSON-RPC response body.
400Invalid request
Check the JSON-RPC envelope, parameters, and protocol version.
406Not acceptable
Accept must include application/json and text/event-stream.
429Rate limited
Wait for the Retry-After interval before making another request.
401Unauthorized
A valid, unexpired MCP bearer token is required.
403Access denied
Your connection needs access to this workspace and the requested operation.