PlatformDocs
MCP server

downgrade_plan

Schedules the subscription to change to a new number of leads per month from the next billing date; nothing is charged or refunded now and current credits stay until then.

View as Markdown

Downgrade plan · Changes data · Acts outside your account

Schedules the subscription to change to a new number of leads per month from the next billing date; nothing is charged or refunded now and current credits stay until then. Current add-ons are kept. Returns tierName, leads, the new monthly price and effectiveAt (when it takes effect); get_subscription then shows it under pendingDowngrade. Use upgrade_plan for more leads now; to stop paying use cancel_subscription or pause_subscription. Confirm with the user before calling.

ConnectionAccount-owner URL or OAuth (not a team member URL)

Parameters

ParameterTypeRequiredAcceptsDescription
leadsintegerYes1–1000000Leads per month of the plan to switch to at the next billing date: a whole number from 1 to 1,000,000.
annualbooleanNoanytrue for yearly billing, false for monthly. Leave it out to keep the current billing interval; only pass a value when the user wants to switch.

Tool definition

What your assistant receives from tools/list:

{
  "name": "downgrade_plan",
  "title": "Downgrade plan",
  "annotations": {
    "title": "Downgrade plan",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "leads": {
        "type": "integer",
        "minimum": 1,
        "maximum": 1000000,
        "description": "Leads per month of the plan to switch to at the next billing date: a whole number from 1 to 1,000,000."
      },
      "annual": {
        "type": "boolean",
        "description": "true for yearly billing, false for monthly. Leave it out to keep the current billing interval; only pass a value when the user wants to switch."
      }
    },
    "required": [
      "leads"
    ]
  }
}

Used in

On this page