Create org webhook
curl --request POST \
--url https://api.sandbox.trio.com.br/webhooks \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"authentication_method": "url_secret",
"entity_id": "019f2433-fbf3-096e-a3f7-ffd9ae43d1c8",
"event_categories_allowed": [
{
"category": "boleto",
"types": [
"settled",
"created"
]
}
],
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": null,
"oauth_client_secret": null,
"oauth_scope": "",
"oauth_url": null
}
'import requests
url = "https://api.sandbox.trio.com.br/webhooks"
payload = {
"authentication_method": "url_secret",
"entity_id": "019f2433-fbf3-096e-a3f7-ffd9ae43d1c8",
"event_categories_allowed": [
{
"category": "boleto",
"types": ["settled", "created"]
}
],
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": None,
"oauth_client_secret": None,
"oauth_scope": "",
"oauth_url": None
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
authentication_method: 'url_secret',
entity_id: '019f2433-fbf3-096e-a3f7-ffd9ae43d1c8',
event_categories_allowed: [{category: 'boleto', types: ['settled', 'created']}],
notification_key: 'KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==',
notification_secret: 'some_notification_secret',
notification_url: 'https://mynotificationurl.com/endpoint',
oauth_client_id: null,
oauth_client_secret: null,
oauth_scope: '',
oauth_url: null
})
};
fetch('https://api.sandbox.trio.com.br/webhooks', 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.sandbox.trio.com.br/webhooks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'authentication_method' => 'url_secret',
'entity_id' => '019f2433-fbf3-096e-a3f7-ffd9ae43d1c8',
'event_categories_allowed' => [
[
'category' => 'boleto',
'types' => [
'settled',
'created'
]
]
],
'notification_key' => 'KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==',
'notification_secret' => 'some_notification_secret',
'notification_url' => 'https://mynotificationurl.com/endpoint',
'oauth_client_id' => null,
'oauth_client_secret' => null,
'oauth_scope' => '',
'oauth_url' => null
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.trio.com.br/webhooks"
payload := strings.NewReader("{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.trio.com.br/webhooks")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/webhooks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}"
response = http.request(request)
puts response.read_body{
"data": {
"authentication_method": "url_secret",
"company_id": "019f2433-fb00-c23b-da37-2fe6a4f4f5a6",
"entity_id": "019f2433-fb00-37f3-5a3c-b516763fa0b5",
"event_categories_allowed": [
{
"category": "boleto",
"types": [
"settled",
"created"
]
}
],
"id": "019f2433-fb00-498e-3527-783b51c21536",
"inserted_at": "2026-07-02T19:00:14.208505Z",
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": null,
"oauth_client_secret": null,
"oauth_scope": "",
"oauth_url": null,
"org_id": "019f2433-fb00-c2dd-7d0b-395b07e6a93f",
"updated_at": "2026-07-02T19:00:14.208514Z"
}
}{
"errors": [
{
"detail": "null value where string expected",
"source": {
"pointer": "/data/attributes/petName"
},
"title": "Invalid value"
}
]
}{
"errors": [
{
"detail": "null value where string expected",
"source": {
"pointer": "/data/attributes/petName"
},
"title": "Invalid value"
}
]
}Webhooks
Create Webhook
Create a new webhook
POST
/
webhooks
Create org webhook
curl --request POST \
--url https://api.sandbox.trio.com.br/webhooks \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"authentication_method": "url_secret",
"entity_id": "019f2433-fbf3-096e-a3f7-ffd9ae43d1c8",
"event_categories_allowed": [
{
"category": "boleto",
"types": [
"settled",
"created"
]
}
],
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": null,
"oauth_client_secret": null,
"oauth_scope": "",
"oauth_url": null
}
'import requests
url = "https://api.sandbox.trio.com.br/webhooks"
payload = {
"authentication_method": "url_secret",
"entity_id": "019f2433-fbf3-096e-a3f7-ffd9ae43d1c8",
"event_categories_allowed": [
{
"category": "boleto",
"types": ["settled", "created"]
}
],
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": None,
"oauth_client_secret": None,
"oauth_scope": "",
"oauth_url": None
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
authentication_method: 'url_secret',
entity_id: '019f2433-fbf3-096e-a3f7-ffd9ae43d1c8',
event_categories_allowed: [{category: 'boleto', types: ['settled', 'created']}],
notification_key: 'KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==',
notification_secret: 'some_notification_secret',
notification_url: 'https://mynotificationurl.com/endpoint',
oauth_client_id: null,
oauth_client_secret: null,
oauth_scope: '',
oauth_url: null
})
};
fetch('https://api.sandbox.trio.com.br/webhooks', 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.sandbox.trio.com.br/webhooks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'authentication_method' => 'url_secret',
'entity_id' => '019f2433-fbf3-096e-a3f7-ffd9ae43d1c8',
'event_categories_allowed' => [
[
'category' => 'boleto',
'types' => [
'settled',
'created'
]
]
],
'notification_key' => 'KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==',
'notification_secret' => 'some_notification_secret',
'notification_url' => 'https://mynotificationurl.com/endpoint',
'oauth_client_id' => null,
'oauth_client_secret' => null,
'oauth_scope' => '',
'oauth_url' => null
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.trio.com.br/webhooks"
payload := strings.NewReader("{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.sandbox.trio.com.br/webhooks")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.trio.com.br/webhooks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"authentication_method\": \"url_secret\",\n \"entity_id\": \"019f2433-fbf3-096e-a3f7-ffd9ae43d1c8\",\n \"event_categories_allowed\": [\n {\n \"category\": \"boleto\",\n \"types\": [\n \"settled\",\n \"created\"\n ]\n }\n ],\n \"notification_key\": \"KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==\",\n \"notification_secret\": \"some_notification_secret\",\n \"notification_url\": \"https://mynotificationurl.com/endpoint\",\n \"oauth_client_id\": null,\n \"oauth_client_secret\": null,\n \"oauth_scope\": \"\",\n \"oauth_url\": null\n}"
response = http.request(request)
puts response.read_body{
"data": {
"authentication_method": "url_secret",
"company_id": "019f2433-fb00-c23b-da37-2fe6a4f4f5a6",
"entity_id": "019f2433-fb00-37f3-5a3c-b516763fa0b5",
"event_categories_allowed": [
{
"category": "boleto",
"types": [
"settled",
"created"
]
}
],
"id": "019f2433-fb00-498e-3527-783b51c21536",
"inserted_at": "2026-07-02T19:00:14.208505Z",
"notification_key": "KXe1JxmdHIcRhAsnbaTBvSGNSQli4I798oGMb8abeMBcKzJoUpWkOQ==",
"notification_secret": "some_notification_secret",
"notification_url": "https://mynotificationurl.com/endpoint",
"oauth_client_id": null,
"oauth_client_secret": null,
"oauth_scope": "",
"oauth_url": null,
"org_id": "019f2433-fb00-c2dd-7d0b-395b07e6a93f",
"updated_at": "2026-07-02T19:00:14.208514Z"
}
}{
"errors": [
{
"detail": "null value where string expected",
"source": {
"pointer": "/data/attributes/petName"
},
"title": "Invalid value"
}
]
}{
"errors": [
{
"detail": "null value where string expected",
"source": {
"pointer": "/data/attributes/petName"
},
"title": "Invalid value"
}
]
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Org webhook parameters
Org webhook creation parameters for IAM access
Webhook authentication method
Notification URL
Bank Account ID
Entity ID
Event categories
Show child attributes
Show child attributes
Notification Key
Notification Secret
OAuth Client ID
OAuth Client Secret
OAuth scope
OAuth URL
Response
Created webhook
A org webhook for communication
⌘I

