Agent Tools

Create tool

Create a new tool for an agent. Tools allow the agent to call external webhooks.

post/v1/senders/{senderId}/agent/tools

Path parameters

senderIdstring required

Request body

namestring required
descriptionstring required
webhookUrlstring uri required

Must be HTTPS.

webhookSecretstring

Signing secret for the webhook. Optional: Zavu generates one when omitted and returns it on this response only. Supply your own if you already have a secret you want reused.

enabledboolean

Response

Tool created.

Example response

{
  "tool": {
    "name": "get_order_status",
    "webhookSecret": "whsec_abc123..."
  }
}