Get all OAuth credentials

GET

webhooks_settings

oauth

TypeScript

const response: Promise<FireblocksResponse<WebhookOAuthList>> = fireblocks.webhooksV2.getWebhookOAuths();

const options = {method: 'GET'};

fetch('https://api.fireblocks.io/v1/webhooks_settings/oauth', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/webhooks_settings/oauth",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/webhooks_settings/oauth"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/webhooks_settings/oauth")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Production treasury gateway",
    "clientId": "my-client-id",
    "url": "https://auth.example.com/oauth/token",
    "authMethod": "client_secret_basic",
    "createdAt": 1625097600000,
    "updatedAt": 1625097600000,
    "customJwtClaims": [
      "aud",
      "resource"
    ],
    "customBodyParams": [
      "scope"
    ],
    "customHeaders": [
      "X-Api-Key"
    ],
    "mtlsClientSignedCert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
  }
]

{
  "message": "<string>",
  "code": 123
}

Response

The workspace's OAuth credentials

string<uuid>

required

The id of the OAuth credentials. Pass this as a webhook's webhookOauthId to attach them.

Example:

"123e4567-e89b-12d3-a456-426614174000"

name

string

required

The label given to this credential set.

Example:

"Production treasury gateway"

clientId

string

required

OAuth client ID used to authenticate with the token endpoint.

Example:

"my-client-id"

url

string

required

Token endpoint URL.

Example:

"https://auth.example.com/oauth/token"

authMethod

string

default:client_secret_basic

required

How the client credentials are presented to the token endpoint: client_secret_basic, client_secret_post or client_secret_jwt. Credentials created without this field report client_secret_basic, which is what they use.

Example:

"client_secret_basic"

createdAt

integer<int64>

required

The date and time the OAuth credentials were created, in milliseconds.

Example:

1625097600000

updatedAt

integer<int64>

required

The date and time the OAuth credentials were last updated, in milliseconds.

Example:

1625097600000

customJwtClaims

string[]

Names of the additional claims placed in the JWT assertion. Claim values are write-only and are never returned. Absent when no custom claims are configured.

Example:

["aud", "resource"]

customBodyParams

string[]

Names of the additional parameters added to the token request body. Parameter values are write-only and are never returned. Absent when no custom parameters are configured.

Example:

["scope"]

customHeaders

string[]

Names of the additional HTTP headers added to the token request sent to the authorization server — not to the webhook delivery, which has its own separate customHeaders. Header values are write-only and are never returned. Absent when no custom headers are configured.

Example:

["X-Api-Key"]

mtlsClientSignedCert

string

PEM-encoded client certificate used for mTLS when fetching OAuth tokens.

Example:

"-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"

TypeScript

const response: Promise<FireblocksResponse<WebhookOAuthList>> = fireblocks.webhooksV2.getWebhookOAuths();

const options = {method: 'GET'};

fetch('https://api.fireblocks.io/v1/webhooks_settings/oauth', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/webhooks_settings/oauth",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/webhooks_settings/oauth"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/webhooks_settings/oauth")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Production treasury gateway",
    "clientId": "my-client-id",
    "url": "https://auth.example.com/oauth/token",
    "authMethod": "client_secret_basic",
    "createdAt": 1625097600000,
    "updatedAt": 1625097600000,
    "customJwtClaims": [
      "aud",
      "resource"
    ],
    "customBodyParams": [
      "scope"
    ],
    "customHeaders": [
      "X-Api-Key"
    ],
    "mtlsClientSignedCert": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
  }
]

{
  "message": "<string>",
  "code": 123
}

Introduction

Errors & Statuses

Data Objects

API Endpoints

Response