Webhooks Overview

Receive real-time data from external services via webhook endpoints.

What Are Webhooks?

Webhooks let you receive real-time data from external services. Instead of polling for updates, services push data to your agntdata webhook endpoint, which stores it for later retrieval.

Use Cases

CRM Notifications

Receive notifications when leads are updated in your CRM.

E-commerce Events

Get notified about orders, refunds, and inventory changes.

CI/CD Pipelines

Receive build and deployment notifications.

Social Monitoring

Get alerts when tracked accounts post new content.

How It Works

1. Create an Endpoint

   Create a webhook endpoint in the agntdata dashboard. Each endpoint gets a unique URL.

2. Configure External Service

   Point your external service’s webhook settings to your agntdata endpoint URL.

3. Receive Deliveries

   When the external service sends data, agntdata stores it as a “delivery”.

4. Process Deliveries

   Fetch deliveries from the dashboard or programmatically via GET /v1/webhook-endpoints/deliveries using your API key, then acknowledge them once processed.

Endpoint URL Format

Each webhook endpoint has a unique URL:

https://api.agntdata.dev/ingest/{hookId}

Example:

https://api.agntdata.dev/ingest/9f3c8a1e-7b25-4f2d-9a88-2c1e7c34a5b1

The hookId is the endpoint’s unique identifier returned when you create the endpoint.

Why Use agntdata Webhooks?

No Server Required

You don’t need to run a server to receive webhooks. agntdata stores deliveries until you’re ready to process them.

Reliable Storage

Deliveries are stored reliably and won’t be lost if your application is temporarily down.

Unified Inbox

Collect webhooks from multiple services in one place. View and manage them from the dashboard.

Replay and Debug

View the raw payload of any delivery. Useful for debugging integration issues.

Dashboard Features

The webhook dashboard provides:

• Endpoint Management — Create, view, and delete endpoints
• Delivery History — View all received webhook payloads
• Payload Inspection — Examine headers and body of each delivery
• Acknowledgment — Mark deliveries as processed

Limits

Limit	Value
Payload size	1 MB
Deliveries per page	100 max

Endpoint names must be 3-50 characters, lowercase alphanumeric with hyphens, and start/end with alphanumeric characters.

Next Steps

Create Endpoints

Learn how to create and manage webhook endpoints.

Receive Webhooks

Understand webhook payload format and handling.

Managing Deliveries

Fetch, paginate, and acknowledge deliveries via the API.