Skip to main content

Endpoints

An endpoint is a public URL that receives webhook events for a project. Providers send HTTP requests to an endpoint's ingest URL; Webhookr stores each request as an event and forwards it to the endpoint's destinations.

Model

FieldDescription
idUnique identifier.
projectIdThe owning project.
nameDisplay name.
slugUnique, URL-safe identifier used in the ingest URL. Generated by Webhookr.
isActiveWhether the endpoint accepts incoming events.
createdAt / updatedAtLifecycle timestamps.

Ingest URL

The ingest URL is the API base URL plus the slug:

https://api.webhookr.tech/v1/ingest/<slug>
  • Accepts any HTTP method and any body.
  • Returns 202 Accepted when the event is stored.
  • No authentication — anyone with the URL can post to it, so treat the slug as a secret.

Slugs may contain letters, numbers, hyphens, and underscores, up to 64 characters. A malformed slug returns 400; an unknown slug returns 404.

Active vs. inactive

isActive pauses an endpoint without deleting it:

  • Active — requests are accepted and stored.
  • Inactive — requests are rejected.

Managing endpoints