Save campaign draft

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Write

Available subject to your connection’s permissions.

Description: Save supplied campaign content, including incomplete drafts. No Ads writes. Updates need the current revision.

Method: tools/call · ads_save_campaign_draft

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.

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.

draft_idstringoptional

format: "uuid"

expected_revisionintegeroptional

minimum: 1

account_idstringrequired

format: "uuid"

namestringrequired

minLength: 1maxLength: 1000

configobjectrequired

additionalProperties: false

EXPAND CONFIG

objectiveenumoptional

enum: ["impressions","clicks","conversions"]

budget_amountstringoptional

maxLength: 40

budget_typeenumoptional

enum: ["lifetime","daily"]

landing_page_configurationobjectoptional

additionalProperties: false

EXPAND LANDING_PAGE_CONFIGURATION

query_string_templatestring | nullrequired

maxLength: 4000

descriptionstringoptional

maxLength: 5000

start_localstringoptional

maxLength: 30

end_localstringoptional

maxLength: 30

ambiguityenumoptional

enum: ["reject","earlier","later"]

all_locationsbooleanoptional

locationsarrayoptional

maxItems: 2500

EXPAND LOCATIONS

Each array item

idstringrequired

maxLength: 255

namestringoptional

maxLength: 300

excluded_locationsarrayoptional

maxItems: 2500

EXPAND EXCLUDED_LOCATIONS

Each array item

idstringrequired

maxLength: 255

namestringoptional

maxLength: 300

conversion_event_setting_idstringoptional

maxLength: 255

existing_campaign_idstringoptional

maxLength: 255

modeenumoptional

enum: ["standard","product_feed"]

product_feed_idstringoptional

maxLength: 255

brief_idstringoptional

format: "uuid"

audience_idsarrayoptional

maxItems: 100

EXPAND AUDIENCE_IDS

Each array item

{
  "type": "string",
  "maxLength": 255
}

excluded_audience_idsarrayoptional

maxItems: 100

EXPAND EXCLUDED_AUDIENCE_IDS

Each array item

{
  "type": "string",
  "maxLength": 255
}

platformsarrayoptional

maxItems: 3

EXPAND PLATFORMS

Each array item

{
  "enum": [
    "ios_app",
    "android_app",
    "web"
  ]
}

utm_parametersobjectoptional

groupsarrayoptional

maxItems: 30

EXPAND GROUPS

Each array item

idstringrequired

pattern: "^[A-Za-z0-9_-]{1,80}$"

namestringoptional

maxLength: 1000

descriptionstringoptional

maxLength: 5000

existing_ad_group_idstringoptional

maxLength: 255

landing_page_configurationobjectoptional

additionalProperties: false

EXPAND LANDING_PAGE_CONFIGURATION

query_string_templatestring | nullrequired

maxLength: 4000

context_hintsarrayoptional

maxItems: 2000

EXPAND CONTEXT_HINTS

Each array item

{
  "type": "string",
  "maxLength": 1000
}

bid_amountstringoptional

maxLength: 40

strategyenumoptional

enum: ["fixed_bid","maximize_clicks","maximize_conversions"]

custom_audience_bid_multipliersarrayoptional

maxItems: 100

EXPAND CUSTOM_AUDIENCE_BID_MULTIPLIERS

Each array item

custom_audience_idstringrequired

maxLength: 255

bid_multiplier_microsintegerrequired

minimum: 100000maximum: 10000000

product_setobjectoptional

additionalProperties: false

EXPAND PRODUCT_SET

product_feed_idstringrequired

maxLength: 255

filtersarrayoptional

maxItems: 50

EXPAND FILTERS

Each array item

fieldstringrequired

maxLength: 100

operatorenumrequired

enum: ["in","gt","gte","lt","lte"]

valuesarrayrequired

maxItems: 100

EXPAND VALUES

Each array item

{
  "type": "string",
  "maxLength": 1000
}

adsarrayoptional

maxItems: 100

EXPAND ADS

Each array item

idstringrequired

pattern: "^[A-Za-z0-9_-]{1,80}$"

namestringoptional

maxLength: 1000

titlestringoptional

maxLength: 200

bodystringoptional

maxLength: 1000

target_urlstringoptional

maxLength: 2048

source_image_urlstringoptional

maxLength: 2048

asset_idstringoptional

format: "uuid"

file_idstringoptional

maxLength: 255

pricestringoptional

maxLength: 100

hookstringoptional

maxLength: 500

offerstringoptional

maxLength: 500

brief_idstringoptional

format: "uuid"

Full JSON Schema

{
  "type": "object",
  "properties": {
    "draft_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 1
    },
    "account_id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000
    },
    "config": {
      "type": "object",
      "properties": {
        "objective": {
          "enum": [
            "impressions",
            "clicks",
            "conversions"
          ]
        },
        "budget_amount": {
          "type": "string",
          "maxLength": 40
        },
        "budget_type": {
          "enum": [
            "lifetime",
            "daily"
          ]
        },
        "landing_page_configuration": {
          "type": "object",
          "properties": {
            "query_string_template": {
              "type": [
                "string",
                "null"
              ],
              "maxLength": 4000
            }
          },
          "required": [
            "query_string_template"
          ],
          "additionalProperties": false
        },
        "description": {
          "type": "string",
          "maxLength": 5000
        },
        "start_local": {
          "type": "string",
          "maxLength": 30
        },
        "end_local": {
          "type": "string",
          "maxLength": 30
        },
        "ambiguity": {
          "enum": [
            "reject",
            "earlier",
            "later"
          ]
        },
        "all_locations": {
          "type": "boolean"
        },
        "locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 255
              },
              "name": {
                "type": "string",
                "maxLength": 300
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "maxItems": 2500
        },
        "excluded_locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "maxLength": 255
              },
              "name": {
                "type": "string",
                "maxLength": 300
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "maxItems": 2500
        },
        "conversion_event_setting_id": {
          "type": "string",
          "maxLength": 255
        },
        "existing_campaign_id": {
          "type": "string",
          "maxLength": 255
        },
        "mode": {
          "enum": [
            "standard",
            "product_feed"
          ]
        },
        "product_feed_id": {
          "type": "string",
          "maxLength": 255
        },
        "brief_id": {
          "type": "string",
          "format": "uuid"
        },
        "audience_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 100
        },
        "excluded_audience_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 100
        },
        "platforms": {
          "type": "array",
          "items": {
            "enum": [
              "ios_app",
              "android_app",
              "web"
            ]
          },
          "maxItems": 3
        },
        "utm_parameters": {
          "type": "object",
          "maxProperties": 20,
          "propertyNames": {
            "pattern": "^utm_[a-z0-9_]+$"
          },
          "additionalProperties": {
            "type": "string",
            "maxLength": 500
          }
        },
        "groups": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,80}$"
              },
              "name": {
                "type": "string",
                "maxLength": 1000
              },
              "description": {
                "type": "string",
                "maxLength": 5000
              },
              "existing_ad_group_id": {
                "type": "string",
                "maxLength": 255
              },
              "landing_page_configuration": {
                "type": "object",
                "properties": {
                  "query_string_template": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 4000
                  }
                },
                "required": [
                  "query_string_template"
                ],
                "additionalProperties": false
              },
              "context_hints": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 1000
                },
                "maxItems": 2000
              },
              "bid_amount": {
                "type": "string",
                "maxLength": 40
              },
              "strategy": {
                "enum": [
                  "fixed_bid",
                  "maximize_clicks",
                  "maximize_conversions"
                ]
              },
              "custom_audience_bid_multipliers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "custom_audience_id": {
                      "type": "string",
                      "maxLength": 255
                    },
                    "bid_multiplier_micros": {
                      "type": "integer",
                      "minimum": 100000,
                      "maximum": 10000000
                    }
                  },
                  "required": [
                    "custom_audience_id",
                    "bid_multiplier_micros"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 100
              },
              "product_set": {
                "type": "object",
                "properties": {
                  "product_feed_id": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "filters": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "field": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "operator": {
                          "enum": [
                            "in",
                            "gt",
                            "gte",
                            "lt",
                            "lte"
                          ]
                        },
                        "values": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 1000
                          },
                          "maxItems": 100
                        }
                      },
                      "required": [
                        "field",
                        "operator",
                        "values"
                      ],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  }
                },
                "required": [
                  "product_feed_id"
                ],
                "additionalProperties": false
              },
              "ads": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,80}$"
                    },
                    "name": {
                      "type": "string",
                      "maxLength": 1000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 200
                    },
                    "body": {
                      "type": "string",
                      "maxLength": 1000
                    },
                    "target_url": {
                      "type": "string",
                      "maxLength": 2048
                    },
                    "source_image_url": {
                      "type": "string",
                      "maxLength": 2048
                    },
                    "asset_id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "file_id": {
                      "type": "string",
                      "maxLength": 255
                    },
                    "price": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "hook": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "offer": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "brief_id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 100
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "maxItems": 30
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "required": [
    "account_id",
    "name",
    "config"
  ],
  "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.