Save conversion setup

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Write

Available subject to your connection’s permissions.

Description: Save or edit an Advarde conversion draft. No upstream changes. Updates require expected_revision; editing invalidates an existing review proposal. A configured source/account cannot be reassigned.

Method: tools/call · ads_save_conversion_setup

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.

setup_idstringoptional

format: "uuid"

expected_revisionintegeroptional

minimum: 1

account_idstringrequired

format: "uuid"

configobjectrequired

additionalProperties: false

EXPAND CONFIG

namestringrequired

minLength: 3maxLength: 160

website_urlstringrequired

format: "uri"maxLength: 2000

environmentenumoptional

enum: ["production","test"]

preset_idenumrequired

enum: ["lead_generation","booking","ecommerce","saas"]

preset_versionschemaoptional

const: 1

eventsarrayrequired

minItems: 1maxItems: 10uniqueItems: true

EXPAND EVENTS

Each array item

{
  "enum": [
    "page_viewed",
    "contents_viewed",
    "items_added",
    "checkout_started",
    "order_created",
    "lead_created",
    "appointment_scheduled",
    "registration_completed",
    "trial_started",
    "subscription_created"
  ]
}

primary_eventenumrequired

enum:

["page_viewed","contents_viewed","items_added","checkout_started","order_created","lead_created","appointment_scheduled","registration_completed","trial_started","subscription_created"]

source_idstringoptional

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

Full JSON Schema

{
  "type": "object",
  "properties": {
    "setup_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 1
    },
    "account_id": {
      "type": "string",
      "format": "uuid"
    },
    "config": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "minLength": 3,
          "maxLength": 160
        },
        "website_url": {
          "type": "string",
          "format": "uri",
          "maxLength": 2000
        },
        "environment": {
          "enum": [
            "production",
            "test"
          ]
        },
        "preset_id": {
          "enum": [
            "lead_generation",
            "booking",
            "ecommerce",
            "saas"
          ]
        },
        "preset_version": {
          "const": 1
        },
        "events": {
          "type": "array",
          "items": {
            "enum": [
              "page_viewed",
              "contents_viewed",
              "items_added",
              "checkout_started",
              "order_created",
              "lead_created",
              "appointment_scheduled",
              "registration_completed",
              "trial_started",
              "subscription_created"
            ]
          },
          "minItems": 1,
          "maxItems": 10,
          "uniqueItems": true
        },
        "primary_event": {
          "enum": [
            "page_viewed",
            "contents_viewed",
            "items_added",
            "checkout_started",
            "order_created",
            "lead_created",
            "appointment_scheduled",
            "registration_completed",
            "trial_started",
            "subscription_created"
          ]
        },
        "source_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{1,255}$"
        }
      },
      "required": [
        "name",
        "website_url",
        "preset_id",
        "events",
        "primary_event"
      ]
    }
  },
  "required": [
    "account_id",
    "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.