Creating Endpoints

Create and manage webhook endpoints to receive data from external services.

Creating an Endpoint

1. Navigate to Webhooks

   Go to Webhooks in the dashboard sidebar.

2. Click Create Endpoint

   Click the Create Endpoint button.

3. Configure Endpoint

   Enter a name and optional description for your endpoint.

   • Name: A URL-safe identifier (e.g., stripe-events, github-hooks)
   • Description: Optional notes about what this endpoint is for
4. Copy the URL

   After creation, copy the endpoint URL to configure in your external service.

Endpoint Naming Rules

Endpoint names must follow these rules:

• Length: 3-50 characters
• Characters: Lowercase alphanumeric and hyphens only
• Start/End: Must start and end with an alphanumeric character

Valid Names

• stripe-events
• github-push
• my-webhook-1
• orders

Invalid Names

• ab (too short)
• -webhook (starts with hyphen)
• My_Webhook (uppercase/underscore)
• events/stripe (slashes)

Managing Endpoints

Viewing Endpoints

The Webhooks page in the dashboard shows all endpoints for your workspace, including:

• Endpoint name and description
• Endpoint URL for configuration
• Creation date
• Number of deliveries received

Deleting an Endpoint

To delete an endpoint:

1. Go to Webhooks in the dashboard
2. Click on the endpoint you want to delete
3. Click Delete Endpoint and confirm

Deleting an endpoint deactivates it: the URL stops accepting new deliveries and the endpoint no longer appears in listings. Previously received deliveries are retained so you can still retrieve them via the API.

Because historic deliveries are preserved, endpoint names are reserved even after deletion — pick a new name if you need to recreate a similar endpoint.

Once deleted, the endpoint URL will reject new requests with 404 Webhook endpoint not found. Re-point your upstream service before deleting.

Configuring External Services

Once you have your endpoint URL, configure your external service to send webhooks to it.

Stripe Example

1. Go to Developers → Webhooks in your Stripe dashboard
2. Click Add endpoint
3. Enter your agntdata webhook URL
4. Select the events you want to receive
5. Click Add endpoint

GitHub Example

1. Go to your repository Settings → Webhooks
2. Click Add webhook
3. Enter your agntdata webhook URL as the Payload URL
4. Set Content type to application/json
5. Select events to trigger the webhook
6. Click Add webhook

Generic Services

Most services have a webhook or callback URL setting. Enter your agntdata endpoint URL:

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

The hookId is the endpoint’s unique identifier, returned in the id and url fields when you create the endpoint.

Security Considerations

Endpoint URLs are Semi-Secret

Endpoint URLs are opaque (/ingest/{hookId}) and not publicly discoverable. However, anyone with the URL can send data to it — treat it like a shared secret.

Validate Payloads

When processing deliveries, validate that the payload structure matches what you expect from your source service.

Use Webhook Signatures

Many services (Stripe, GitHub, etc.) sign their payloads. Store the signature from headers and verify it when processing.

Next Steps

Receiving Webhooks

Learn about webhook payload format and structure.

Managing Deliveries

View and acknowledge webhook deliveries.