request_delegation

Active

declared in 0.2.0

Start the human delegation (approval) flow needed for checkout/payment. PREFERRED: pass the buyer's `email` — the gateway emails them a 6-digit code and returns a device_code; ask the user for the code and call submit_delegation_otp. This keeps approval fully in-chat (no link) and you never see the code, so you cannot approve on their behalf. If you omit `email`, it falls back to a browser approval link (device flow) which the user must open; then poll check_delegation. You can never approve a delegation yourself.

Parameters schema

{
  "type": "object",
  "required": [
    "site_id"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Buyer's email. When provided, a one-time approval code is emailed to them and approval happens in-chat via submit_delegation_otp (recommended)."
    },
    "scopes": {
      "type": "array",
      "items": {
        "enum": [
          "read_products",
          "manage_cart",
          "execute_checkout",
          "read_orders"
        ],
        "type": "string"
      },
      "description": "Scopes to request (defaults to all four scopes)"
    },
    "site_id": {
      "type": "string",
      "description": "Site ID requiring delegation"
    },
    "marketing_opt_in": {
      "type": "boolean",
      "description": "Set true ONLY if the buyer explicitly agreed to receive marketing/deals emails (e.g. ticked the opt-in box). Subscribes their email to the consumer mailing list."
    }
  }
}

What this tool wraps· 0 endpoints

min confidence0.70 0.50

No endpoints wrapped at confidence ≥ 0.50.

Parent server

Synchronity

https://github.com/themewireco/synchronity

2/7 registries

View full server →