Skip to main content

Webhooks

External provider events enter Veyra under:

/api/v1/webhooks/

GitHub App webhook​

Production webhook URL:

https://api.veyra.surf/api/v1/webhooks/github/

Veyra verifies GitHub webhook signatures using the configured webhook secret before trusting the payload.

Webhook events can refresh installation/repository state and contribute to execution/reconciliation flows.

Circle webhook​

POST /api/v1/webhooks/circle/

Circle events are used to accelerate wallet/transaction state convergence.

Webhook rule​

A webhook is a signal to reconcile external state, not a shortcut around verification.

Veyra still checks authoritative provider/chain state where the workflow requires it.

Never publish secrets​

Documentation should include webhook URLs but never the configured GitHub or Circle webhook secret.