Skip to main content
POST
Create a gVault webhook
Register an HTTPS endpoint for gVault and fee-wrapper lifecycle events. Store the returned signing secret securely; Ground returns it only once.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string<uri>
required
events
enum<string>[]
required
Minimum array length: 1
Available options:
gvault.allowlist.status_changed,
fee_wrapper.status_changed,
fee_wrapper.fees.status_changed,
fee_wrapper.allowlist.status_changed
description
string | null

Response

Webhook created; secret is returned once.

id
string<uuid>
required
url
string<uri>
required
events
enum<string>[]
required
Available options:
gvault.allowlist.status_changed,
fee_wrapper.status_changed,
fee_wrapper.fees.status_changed,
fee_wrapper.allowlist.status_changed
createdAt
string<date-time>
required
secret
string

Returned only when the webhook is created.