Endpoints API

Create and manage your webhook capture URLs

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.

Show endpoint properties

id · string

Unique identifier for the endpoint.

user_id · string

ID of the owning user.

name · string

Human-readable name you assigned to this endpoint.

public_token · string

Token used to build the capture URL: https://hookdrop.dev/in/{public_token}.

is_active · boolean

Whether the endpoint is accepting incoming webhooks.

metadata · object

Arbitrary key-value metadata attached to the endpoint.

created_at · string

ISO 8601 timestamp of when the endpoint was created.

---

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
}