v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB

Webhooks

Create Webhook

Handshake: on create, Everhour sends a POST to the supplied targetUrl with an X-Hook-Secret header (HMAC-SHA512) and an empty body. The receiver must respond with a 2xx status to complete verification. Send X-Skip-Handshake: 1 to skip verification when the receiver cannot participate.

Scope: a webhook can listen across the whole team or be scoped to a single project. See Webhooks for event types, payload structure, and delivery semantics.

post/hooks

Request body

targetUrlstring required

URL that receives event POSTs.

eventsstring[] required

Events you want to receive.

projectstring nullable

Restrict the subscription to a single project.

Example request

{
  "targetUrl": "https://some-secure-endpoint.com/path",
  "events": [
    "api:time:updated"
  ],
  "project": "ev:12345657890"
}

Response

Created

idnumber required

Webhook ID

targetUrlstring required

eventsstring[] required

projectstring nullable

You can receive events only for specific project

activeboolean

createdAtstring required

Datetime when webhook was created (format: Y-m-d H:i:s)

lastUsedAtstring required

Datetime when webhook was last used (format: Y-m-d H:i:s)

Example response

{
  "id": 12345,
  "targetUrl": "https://some-secure-endpoint.com/path",
  "events": [
    "api:time:updated"
  ],
  "project": "ev:12345657890",
  "active": true,
  "createdAt": "2018-03-05 16:17:14",
  "lastUsedAt": "2018-03-05 20:01:58"
}