Skip to main content
Webhooks

List Webhook Endpoints

List Webhook Endpoints visible to the current account.

Webhook is currently in Beta. APIs, fields, and behavior may change in future versions.
GET /api/v1/forward/webhook/endpoints

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT or administrator SAT>

Query parameters

ParameterTypeRequiredDescription
limitintegerNoPage size. Defaults to 20; range 1-100.
after_idstringNolast_id from the previous response, used to read the next page.

Example request

curl -s 'https://api.qoder.com/api/v1/forward/webhook/endpoints?limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK
{
  "data": [
    {
      "id": "e149c233-1234-4abc-8def-1234567890ab",
      "url": "https://example.com/webhooks/qoder",
      "description": "Schedule notifications",
      "events": [
        "forward.schedule_run.succeeded",
        "forward.schedule_run.failed"
      ],
      "metadata": {
        "environment": "production"
      },
      "active": true,
      "last_success_at": "2026-09-01T09:07:59Z",
      "last_failure_at": null,
      "consecutive_fail": 0,
      "created_at": "2026-09-01T08:00:00Z",
      "updated_at": "2026-09-01T09:07:59Z"
    }
  ],
  "first_id": "e149c233-1234-4abc-8def-1234567890ab",
  "last_id": "e149c233-1234-4abc-8def-1234567890ab",
  "has_more": false
}
For an empty result, data is [], first_id and last_id are null, and has_more is false.

Response fields

FieldTypeDescription
dataobject[]Endpoint objects on the current page.
first_idstring/nullID of the first Endpoint on the page.
last_idstring/nullID of the last Endpoint on the page. Use it as after_id for the next page.
has_morebooleanWhether another page is available.
See Get a Webhook Endpoint for Endpoint fields.

Errors

HTTPTypeTrigger
400invalid_request_errorThe pagination parameters are invalid.
401authentication_errorAuthentication is missing, invalid, or expired.
403permission_errorThe current token cannot manage Webhooks.
500/502/503api_errorThe service is temporarily unavailable.