Email
Inboxes
Marketing
SMS
Sign
Verify
Forms
Scheduling
Hooks
Risk
Platform
- List webhook endpoints GET
- Create a webhook endpoint POST
- Retrieve a webhook endpoint GET
- Update a webhook endpoint PATCH
- Delete a webhook endpoint DELETE
- Roll a signing secret POST
- Recover failed deliveries POST
- List an endpoint's deliveries GET
- Retrieve a delivery GET
- Retry a delivery POST
- Open a webhook listener POST
- Poll a webhook listener POST
- Close a webhook listener DELETE
- Send a test event POST
List webhook endpoints
GET
/v1/webhook_endpoints
Every endpoint of the API key's environment, oldest first. Webhook endpoints belong to the API key's own environment: a coss_test_… key only ever sees sandbox endpoints, and a coss_live_… key only production ones.
bearerAuthheader
AuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
Coss-Version?"2026-10-10"The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.
Value in
"2026-10-10"The environment's webhook endpoints.
application/json- response
- response
- …
object*"list"Value in
"list"data*array<>has_more*booleanimport { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.webhookEndpoints.list();{ "object": "list", "data": [ { "object": "webhook_endpoint", "id": "whep_01k7c8m4q2f3e9v6t5r1n0p8yz", "url": "https://example.com/webhooks/coss", "description": "Production receiver", "event_types": [ "email.delivered", "email.bounced" ], "api_version": "2026-10-10", "enabled": true, "disabled_reason": null, "disabled_at": null, "failing_since": null, "previous_secret_expires_at": null, "created_at": "2026-01-15T09:30:00.000Z", "updated_at": "2026-01-15T09:30:00.000Z" } ], "has_more": false}