POST

Create 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.

Body Params

object

enterpriseId string

matches ^[0-9a-f]{32}$
organizationId string

matches ^[0-9a-f]{32}$

Responses

200

Response Body

object

secret string required

400

Bad Request

Response Body

object

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

403

Forbidden

Response Body

object

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

404

Not Found

Response Body

object

name string

Error code
context map of objects required

Properties that apply to a specific error name
context object
- <key> object
error string required

Human-readable error message
requestId string required

Client request id

curl --request POST \ --url 'https://app.bitgo-test.com/api/v2/webhook/secret' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{,"enterpriseId":"59cd72485007a239fb00282ed480da1f","organizationId":"59cd72485007a239fb00282ed480da1f"}'

const url = 'https://app.bitgo-test.com/api/v2/webhook/secret'; const options = { method: 'POST', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'content-type': 'application/json'}, body: JSON.stringify({,"enterpriseId":"59cd72485007a239fb00282ed480da1f","organizationId":"59cd72485007a239fb00282ed480da1f"}) }; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/webhook/secret") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["content-type"] = 'application/json' request.body = '{,"enterpriseId":"59cd72485007a239fb00282ed480da1f","organizationId":"59cd72485007a239fb00282ed480da1f"}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/v2/webhook/secret', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'content-type' => 'application/json', ], 'body' => '{,"enterpriseId":"59cd72485007a239fb00282ed480da1f","organizationId":"59cd72485007a239fb00282ed480da1f"}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/webhook/secret" payload = {,"enterpriseId":"59cd72485007a239fb00282ed480da1f","organizationId":"59cd72485007a239fb00282ed480da1f"} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)