Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bobprince.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

An endpoint is a unique URL that captures incoming webhook events. Each endpoint has a public_token that you use to build its capture URL: 
https://hookdrop.dev/in/{public_token}
Point any webhook source at this URL and Hookdrop will capture the request for inspection and forwarding.

​
List endpoints

Returns all endpoints belonging to your account, ordered by creation date (newest first). 
curl https://hookdrop.dev/api/endpoints \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response 
{
  "endpoints": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_id": "3f6e2a91-bd14-4c3a-9c71-8e2d1f0a4b56",
      "name": "Stripe payments",
      "public_token": "4f9e1c2a8b3d7e5f",
      "is_active": true,
      "metadata": {},
      "created_at": "2026-04-01T10:00:00.000Z"
    }
  ]
}
​
endpoints
array
required
List of endpoint objects.

​
Create an endpoint

Creates a new endpoint and returns its capture URL token. 
curl -X POST https://hookdrop.dev/api/endpoints \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Stripe payments"}'
Request body
​
name
string
required
A human-readable label for this endpoint (e.g. "Stripe payments").
Response 
{
  "endpoint": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user_id": "3f6e2a91-bd14-4c3a-9c71-8e2d1f0a4b56",
    "name": "Stripe payments",
    "public_token": "4f9e1c2a8b3d7e5f",
    "is_active": true,
    "metadata": {},
    "created_at": "2026-04-01T10:00:00.000Z"
  }
}
Your capture URL is: 
https://hookdrop.dev/in/4f9e1c2a8b3d7e5f

​
Get an endpoint

Returns a single endpoint including its associated destinations. 
curl https://hookdrop.dev/api/endpoints/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Path parameters
​
id
string
required
The endpoint ID.
Response 
{
  "endpoint": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Stripe payments",
    "public_token": "4f9e1c2a8b3d7e5f",
    "is_active": true,
    "metadata": {},
    "created_at": "2026-04-01T10:00:00.000Z",
    "destinations": []
  }
}

​
Update an endpoint

Updates the name or active status of an endpoint. Only the fields you include are changed. 
curl -X PATCH https://hookdrop.dev/api/endpoints/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Stripe production", "is_active": false}'
Path parameters
​
id
string
required
The endpoint ID.
Request body
​
name
string
New display name for the endpoint.
​
is_active
boolean
Set to false to stop the endpoint from accepting new webhooks.
​
metadata
object
Arbitrary key-value pairs you can attach to the endpoint for your own reference.
Response 
{
  "endpoint": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Stripe production",
    "public_token": "4f9e1c2a8b3d7e5f",
    "is_active": false,
    "metadata": {},
    "created_at": "2026-04-01T10:00:00.000Z"
  }
}

​
Delete an endpoint

Permanently deletes an endpoint and all its associated events and destinations. 
curl -X DELETE https://hookdrop.dev/api/endpoints/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Path parameters
​
id
string
required
The endpoint ID.
Response 
{
  "ok": true
}