Tools

curl -X POST "https://prod.featherhq.com/api/v1/tools" \
  -H "X-API-Key: $FEATHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Create follow-up task",
    "slug": "create_follow_up_task",
    "description": "Create a follow-up task in the CRM after a customer conversation.",
    "speech": "I am creating the follow-up now.",
    "structure": {
      "url": "https://api.example.com/tasks",
      "method": "POST",
      "headers": [
        {
          "key": "Authorization",
          "value": "Bearer YOUR_BACKEND_TOKEN",
          "secure": true
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "body": {
        "title": "{{task_title}}",
        "ownerId": "{{owner_id}}",
        "customerId": "{{customer_id}}",
        "notes": "{{notes}}"
      },
      "timeout": 30,
      "variables": [
        {
          "name": "task_title",
          "type": "str",
          "description": "Short action-oriented task title",
          "required": true
        },
        {
          "name": "owner_id",
          "type": "str",
          "description": "CRM owner identifier",
          "required": true
        },
        {
          "name": "customer_id",
          "type": "str",
          "description": "Customer identifier in the CRM",
          "required": true
        },
        {
          "name": "notes",
          "type": "str",
          "description": "Freeform notes about the follow-up",
          "required": false
        }
      ]
    }
  }'