Hub Docs User documentation
Back to home
Hub Docs

Triggering a Skill from a Webhook

What you'll do

Create a Webhook Skill on an Agent and configure an external system to send data to it.

Before you start

You need access to the Tenet admin Space. You should also have access to configure the external system (form builder, CRM, accounting software, etc.) that will send the webhook.

Steps

Step 1: Create the Agent and Webhook Skill

  1. In Tenet, go to Agents.
  2. Create or open an Agent.
  3. Click Add Skill and select type Webhook.
  4. Hub generates a webhook URL and API key. Copy both (you'll need them for the external system).
  5. Click Save.

Example webhook URL:

https://hub.example.com/api/tenant-name/webhooks/skills/{skill-id}

The API key looks like: abc123def456...

Step 2: Configure the external system

In your external system (form provider, CRM, accounting system, etc.):

  1. Find the webhook or outbound integration settings.
  2. Enter the webhook URL (from step 1).
  3. Add an authorization header: X-API-Key: {api-key} (replace with your key).
  4. Set the request body to send the data you want as JSON.
  5. Test the webhook to verify it works.

Example webhook request:

POST https://hub.example.com/api/tenant-name/webhooks/skills/{skill-id}
Header: X-API-Key: abc123def456...
Body: {
  "form_submission": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Please review my application"
  }
}

Step 3: Test end-to-end

  1. Trigger the external system to send a webhook (e.g., submit a form).
  2. Check the Agent's execution log in Hub.
  3. Verify that the Agent received the data and took the expected action.

What happens next

Every time the external system sends data to the webhook:

  1. Hub receives the request.
  2. The Agent's Skill is triggered with the data.
  3. The Agent processes it and takes action (create records, tasks, etc.).
  4. The external system receives the Agent's response.

If there's an error (bad API key, network issue, Agent failure), the external system gets an error response.

Related