curl --request POST \
--url https://api.augustus.com/v1/webhook_subscriptions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"url": "https://sandbox.example.com/webhooks/augustus",
"events": [
"payout.sent"
]
}
'import requests
url = "https://api.augustus.com/v1/webhook_subscriptions/{id}"
payload = {
"url": "https://sandbox.example.com/webhooks/augustus",
"events": ["payout.sent"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({url: 'https://sandbox.example.com/webhooks/augustus', events: ['payout.sent']})
};
fetch('https://api.augustus.com/v1/webhook_subscriptions/{id}', 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.augustus.com/v1/webhook_subscriptions/{id}",
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([
'url' => 'https://sandbox.example.com/webhooks/augustus',
'events' => [
'payout.sent'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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.augustus.com/v1/webhook_subscriptions/{id}"
payload := strings.NewReader("{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
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.augustus.com/v1/webhook_subscriptions/{id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.augustus.com/v1/webhook_subscriptions/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440009",
"type": "webhook_subscription",
"url": "https://sandbox.example.com/webhooks/augustus",
"events": [
"payout.sent"
],
"metadata": {
"invoice_id": "INV-2026-0042"
},
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:35:00Z"
}Update webhook subscription
Updates the URL and/or subscribed events.
curl --request POST \
--url https://api.augustus.com/v1/webhook_subscriptions/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"url": "https://sandbox.example.com/webhooks/augustus",
"events": [
"payout.sent"
]
}
'import requests
url = "https://api.augustus.com/v1/webhook_subscriptions/{id}"
payload = {
"url": "https://sandbox.example.com/webhooks/augustus",
"events": ["payout.sent"]
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({url: 'https://sandbox.example.com/webhooks/augustus', events: ['payout.sent']})
};
fetch('https://api.augustus.com/v1/webhook_subscriptions/{id}', 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.augustus.com/v1/webhook_subscriptions/{id}",
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([
'url' => 'https://sandbox.example.com/webhooks/augustus',
'events' => [
'payout.sent'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$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.augustus.com/v1/webhook_subscriptions/{id}"
payload := strings.NewReader("{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
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.augustus.com/v1/webhook_subscriptions/{id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.augustus.com/v1/webhook_subscriptions/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"https://sandbox.example.com/webhooks/augustus\",\n \"events\": [\n \"payout.sent\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "550e8400-e29b-41d4-a716-446655440009",
"type": "webhook_subscription",
"url": "https://sandbox.example.com/webhooks/augustus",
"events": [
"payout.sent"
],
"metadata": {
"invoice_id": "INV-2026-0042"
},
"created_at": "2026-01-15T10:30:00Z",
"updated_at": "2026-01-15T10:35:00Z"
}Authorizations
Bearer token for authentication with Augustus Banking API
Headers
Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.
Path Parameters
Unique identifier of the webhook subscription.
"550e8400-e29b-41d4-a716-446655440009"
Body
Fields to update
The new HTTPS URL. Omit or send null to keep the current URL.
^https:\/\/.*"https://sandbox.example.com/webhooks/augustus"
New event types. Omit or send null to keep the current events. Use ["*"] for all events.
1Event type to subscribe to. Use "*" for all events.
payout.initiated, payout.submitted, payout.sent, payout.failed, payout.returned, return.initiated, return.submitted, return.sent, return.failed, return.returned, deposit.settled, conversion.created, conversion.completed, conversion.failed, account_holder.active, account_holder.closed, counterparty.created, counterparty.verified, counterparty.rejected, counterparty.blocked, counterparty.unblocked, counterparty.updated, * ["payout.sent"]
Response
Success
Unique identifier of the webhook subscription.
"550e8400-e29b-41d4-a716-446655440009"
Resource type discriminator.
webhook_subscription The HTTPS URL where webhook events are delivered.
"https://sandbox.example.com/webhooks/augustus"
Event types this subscription receives.
Event type the subscription receives.
payout.initiated, payout.submitted, payout.sent, payout.failed, payout.returned, return.initiated, return.submitted, return.sent, return.failed, return.returned, deposit.settled, conversion.created, conversion.completed, conversion.failed, account_holder.active, account_holder.closed, counterparty.created, counterparty.verified, counterparty.rejected, counterparty.blocked, counterparty.unblocked, counterparty.updated ["payout.sent"]
Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
Show child attributes
Show child attributes
{ "invoice_id": "INV-2026-0042" }
ISO 8601 UTC timestamp when the subscription was created.
"2026-01-15T10:30:00Z"
ISO 8601 UTC timestamp when the subscription was last updated.
"2026-01-15T10:35:00Z"
Was this page helpful?