Ctrl+K

Create webhook secret

post/api/v2/webhook/secret

Create a webhook secret for a specified enterprise or organization. This secret will be used to generate webhook notification signatures so that you can verify that the notification comes from BitGo using the v2.webhook.notification.verify endpoint. The secret can be rotated by calling this endpoint again at a cadence of once every 5 minutes. You must specify exactly one of 'enterpriseId' or 'organizationId'. The requester must be an admin of the specified enterprise or organization.

Request Body

enterpriseId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organizationId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$

200 Response

secret string required

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id