Skip to main content

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.