request_playbook_setup
Create a setup request for secrets and connections a playbook still needs, without collecting secret values in chat. Never ask the user to paste a secret value into chat. Use when verify_playbook or run_scratch_code reports missing secrets or disconnected integrations or MCP connectors. Without recipientEmail, returns setupUrl for the user to complete in the browser. With recipientEmail, emails that person the link instead and does not return the URL. Returns { needed: false } when nothing is missing. Links expire after 48 hours; a new link without recipientEmail invalidates the previous one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"playbookId": "<playbookId>"
},
"name": "request_playbook_setup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| playbookId | Yes | Playbook that needs secrets or connections. | |
| recipientEmail | No | Email of someone else who should complete setup. Omit to get a link for the user you are working with. |