Endpoints / Creating & Managing

    Endpoints

    An endpoint is a unique webhook URL that captures all incoming requests. Each endpoint has its own URL, optional destination, secret key, and event history.

    Creating an endpoint

    1

    Open the Webhooks page

    Navigate to Dashboard → Webhooks and click "New Endpoint".

    2

    Configure the endpoint

    Fill in:

    • · Name — A label for this endpoint (e.g. stripe-prod)
    • · Destination URL — (optional) Where to forward incoming events
    3

    Copy your webhook URL

    After creating, your endpoint card shows the webhook URL. Copy it and paste it into your service's webhook settings.

    text
    https://paggio.dev/api/webhook/{your-slug}

    Endpoint URL

    Each endpoint gets a unique slug-based URL. The slug is auto-generated from the endpoint name and guaranteed to be unique across all users.

    bash
    # Your endpoint URL format:
https://paggio.dev/api/webhook/{slug}

# Example:
https://paggio.dev/api/webhook/stripe-prod-abc123

    Destination URL

    The destination URL is your real application endpoint. When Paggio receives a webhook, it forwards the original payload and headers to this URL.

    • → Leave blank to capture-only (no forwarding)
    • → Set to your production URL for live forwarding
    • → Update anytime — existing events can still be replayed to the new URL
    Public accessibility:The destination URL must be publicly accessible. Paggio cannot reach internal network URLs or localhost from the cloud. For local development, use a tunnel like ngrok, or replay events manually to localhost.

    Secret key

    Each endpoint has a signing secret in the format whsec_.... This is used to verify that incoming webhooks were signed by Paggio (for future HMAC verification support).

    You can view and regenerate secrets from the Settings → Security page.

    bash
    # Example secret key
whsec_abc123def456...

    Endpoint health

    Each endpoint card shows a health indicator based on the ratio of delivered to failed events (pending/captured events are excluded from the calculation):

    Success rateStatus
    ≥ 90%Healthy
    50–89%Degraded
    < 50%Unhealthy
    No terminal eventsCapturing

    Deleting an endpoint

    Deleting an endpoint permanently removes the endpoint and all associated events. This action cannot be undone.

    Warning:Deleted endpoints stop accepting new webhooks immediately. Any service still pointing at the old URL will receive a 404 Not Found response.

    Sending a test request

    You can test any endpoint with a simple cURL command:

    bash
    curl -X POST https://paggio.dev/api/webhook/{your-slug} \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"hello": "world"}}'