GetItDoneGetItDone Docs
API ReferenceWebhook endpoints

Verify a webhook endpoint

POST
/v1/webhook-endpoints/{endpoint_id}/verify

Live, synchronous probe: SSRF-checks the stored URL, then POSTs a signed synthetic test request (Standard Webhooks headers; event type webhook.verification — NOT part of the delivery vocabulary, never persisted as a WebhookEvent) and requires a 2xx to mark the endpoint verified. This is a re-runnable probe, not a consequential write — no Idempotency-Key support (idempotent: false). A failure reports verified: false with a reason and does NOT unset a previously-earned verified state.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Path Parameters

endpoint_id*string

Response Body

The verification probe result.

application/json
  1. response

Result of a live, synchronous verification probe. A failure does NOT unset a previously-earned verified state — only a success ever (re)sets it.

verified*boolean

True when the endpoint answered the signed test request with a 2xx status. On true, the endpoint's verified state is set.

status?integer

The HTTP status the endpoint returned, when a response was received at all (absent for a blocked/timed-out/network-failed probe).

Range-9007199254740991 <= value <= 9007199254740991
reason?string

Present when verified is false — why the probe failed.

Example Request
curl -X POST 'https://app.nowgetitdone.com/v1/webhook-endpoints/string/verify'
Example Response
{  "verified": true,  "status": 200,  "reason": "string"}

Rotate a webhook endpoint secret POST

Create-overlap-revoke rotation: mints a NEW signing secret (returned ONCE, same as create) and moves the CURRENT secret to previous_secret_expires_at-bounded…

Send a test event to a webhook endpoint POST

Sends a synchronous, signed sample of a REAL event type (default task.created, using a representative sample task payload in the same TaskDto shape real…