Endpoints

Create an endpoint

Creates a capture endpoint and returns it, including its capture url. Send webhooks to that URL immediately — no further setup.

Pass ttlSeconds (60–86400) to create an ephemeral endpoint for CI: it answers 404 after expiry and is deleted, together with everything it captured, by the retention sweep. Endpoint creation counts against the plan's endpoint limit either way.

POST
/api/v1/endpoints
AuthorizationBearer <token>

API key in the Authorization header: Authorization: Bearer wv_live_…. Keys are created on the API keys page in the app, shown once, and scoped to your workspace. X-Api-Key: wv_live_… is accepted as a fallback for tools that can't set Authorization.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "url": "string",
  "isActive": true,
  "createdAt": "2019-08-24T14:15:22Z",
  "lastRequestAt": "2019-08-24T14:15:22Z",
  "expiresAt": "2019-08-24T14:15:22Z",
  "storedRequestCount": 0,
  "responseStatusCode": 0,
  "responseContentType": "string",
  "responseHeaders": {
    "property1": "string",
    "property2": "string"
  },
  "responseBody": "string",
  "forwardingEnabled": true,
  "forwardUrl": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "traceId": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "traceId": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "traceId": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "traceId": "string"
}

On this page