For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sample appsIntegrationsDiscordPlaygroundDevEx repo
GuidesSDK ReferenceAPI Reference
GuidesSDK ReferenceAPI Reference
  • Get Started
    • Introduction
    • Quickstart
    • Manage your plan
    • Rate limits
    • Release notes
    • Migration guide
  • Guides
    • Search
    • Analyze videos
    • Segment videos
    • Create embeddings
  • Concepts
    • Models
    • Upload and processing methods
    • Indexes
    • Modalities
    • Multimodal large language models
  • Cloud partner integrations
    • Amazon Bedrock
  • Advanced
    • Organizations
    • Fine-tuning
    • Webhooks
      • Manage webhooks
      • Requirements for processing notifications
      • Response schema
    • Metadata
    • Model context protocol
    • Claude Code Plugin
  • Resources
    • Platform overview
    • Playground
    • TwelveLabs SDKs
    • Frequently asked questions
    • Use cases
    • Sample applications
    • Partner integrations
    • From the community
LogoLogo
Sample appsIntegrationsDiscordPlaygroundDevEx repo
On this page
  • Register a webhook
  • Remove a webhook
  • Enable or disable a webhook
  • Retrieve your secret key
AdvancedWebhooks

Manage webhooks

Was this page helpful?
Previous

Requirements for processing notifications

Next
Built with

This topic explains how you can use the Webhooks section of the Dashboard to manage your webhooks and retrieve your secret keys.
Note that, for each webhook, the platform tracks the status of your endpoint and displays it in the Status column. The platform uses the following statuses:

  • Not Executed: A notification has not yet been sent to your endpoint.
  • Success: Your endpoint responded with a 2xx code to the latest notification.
  • Failed: Your endpoint failed to respond with a 2xx code to the latest notification. If you see this status, review the information in the Requirements for processing notifications section.

Register a webhook

Before you can receive notifications, you must first register your endpoint by following the steps below:

  1. Go to the Webhooks page.
  2. Select the Add Endpoint button.
  3. In the Add webhook endpoint modal, enter the URL of your endpoint and a brief description.
  4. When you’ve finished, select the Add button. Note that the status will show as Not Executed until the API sends the first request to your endpoint and receives a 2xx response.

Remove a webhook

When a webhook is no longer needed, you can remove it.

  1. Go to the Webhooks page.
  2. Find the webhook that you want to remove. Then, select the trash icon located at the far right end of the row.

Enable or disable a webhook

This section explains how you can temporarily suspend and then reactivate notifications by disabling or enabling a webhook

  1. Go to the Webhooks page.
  2. Find the webhook that you want to enable or disable. Then, use the toggle under Enabled to enable or disable the webhook.

Retrieve your secret key

TwelveLabs signs the notifications it sends to your endpoint by including a signature in each notification. Before you can verify signatures, you must retrieve your secret key.

  1. Go to the Webhooks page.
  2. Find your webhook and select the Reveal Secret button.
  3. Select the copy icon located at the right of the secret key.