architect-create-webhook-tool

Creating a webhook tool is the most common way to connect an agent to an external API, and it fails a lot, almost all from schema mistakes in api_schema.request_body_schema. This skill gets it right on the first write.

All calls use xi-api-key: $API_KEY against https://api.elevenlabs.io.

1. Gather current state first

Before writing anything, make these reads (in parallel where independent):

• GET /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID to confirm the agent and whether it is a single-node agent or a workflow (the workflow is in this config; it changes where you attach the tool later).
• GET /v1/convai/tools to check the tool does not already exist and to match the naming style already in use.

Get the endpoint URL, method, auth method, and request/response shape from the user before you construct the tool. If any are missing, ask for them or the API docs first.

2. Create the tool

POST /v1/convai/tools