v25

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0131545750.2 KB

Re-run verification

Re-runs the GET challenge/echo handshake against the webhook's url and updates its verified state.

post/v2/webhooks/{teamId}/{webhookId}/verify

Path parameters

teamIdstring uuid required

webhookIdstring uuid required

Response

The webhook, with a pending verification status (the handshake runs asynchronously).

idstring uuid required

namestring required

descriptionstring nullable

urlstring uri required

Endpoint events are delivered to.

team_idstring uuid required

enabledboolean required

Disabled webhooks are skipped at delivery time.

verifiedboolean required

True once the endpoint has completed the verification handshake.

verified_atstring date-time nullable

verification_tokenstring

Stable token replayed to the endpoint (as the micro_hook_token query param) during the verification handshake. The endpoint may check it to confirm the request originated from Micro.

created_atstring date-time required

updated_atstring date-time nullable