Hub Docs User documentation
Back to home
Hub Docs

Webhook Skills

What it is

A Webhook Skill is a trigger for an Agent that listens for HTTP requests from external systems. When an external system sends data to Hub via webhook, the matching process runs and processes that data.

When to use it

Use Webhook Skills to integrate Hub with external systems:

  • A form submission tool sends form data to Hub, triggering an Agent to create a record
  • Your accounting system sends transaction data, triggering an Agent to reconcile
  • A CRM sends customer updates, triggering an Agent to update Hub records
  • A pipeline tool sends deal notifications, triggering an Agent to create tasks

Where to find it

Webhook triggers are added in the Tenet admin Space, under Processes. Open the process you want to expose, add a trigger node, and choose Webhook as the trigger type. Each webhook trigger has a unique URL and API key.

How it works

Creating a webhook trigger:

  1. In Tenet, open Processes and pick or create one.
  2. Click Add node and choose a Trigger from the palette.
  3. In the inspector on the right, set Trigger type to Webhook.
  4. Save. Hub generates a unique webhook URL and shows the API key once.
  5. Copy the URL and API key and share them with the external system. If you lose the key, click Regenerate.

External system sends data:

  1. The external system POSTs JSON data to the webhook URL with the API key.
  2. Hub receives the request and verifies the API key.
  3. The Agent's skill is triggered with the data as context.
  4. The Agent processes the data and takes action (create records, tasks, etc.).
  5. Hub returns the Agent's result to the external system.

Security:

  • Each Webhook Skill has a unique API key. Share it only with the external system that needs it.
  • Requests without a valid API key are rejected.
  • Webhook URLs are rate-limited to prevent abuse.

Related