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 Agent 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 Skills are created in the Tenet admin space as part of Agent configuration. Each Webhook Skill has a unique URL and API key.

How it works

Creating a webhook skill:

  1. In Tenet, create or edit an Agent.
  2. Click New Skill and select type Webhook.
  3. Hub generates a unique webhook URL and API key.
  4. Share the URL and API key with the external system.
  5. Save the Skill.

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