Skip to main content
PATCH
/
partner
/
webhooks
/
config
Update webhook config
curl --request PATCH \
  --url https://api.contro.me/v1/partner/webhooks/config \
  --header 'Content-Type: application/json' \
  --header 'x-contro-api-key: <api-key>' \
  --data '
{
  "webhookUrl": "https://your-app.com/webhooks/contro",
  "webhookSecret": "whsec_your_secret_min_16_chars",
  "subscribedEvents": [
    "card.transaction",
    "cardholder.kyc.updated",
    "balance.low"
  ]
}
'
{
  "success": true
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Body

application/json
​
webhookUrl
string<uri>

HTTPS URL to receive events. Must use https://

Example:

"https://your-app.com/webhooks/contro"

​
webhookSecret
string

Secret for HMAC-SHA256 signature verification. Min 16 characters

Minimum string length: 16
Example:

"whsec_your_secret_min_16_chars"

​
subscribedEvents
string[]

Event types to subscribe to

Example:
[
  "card.transaction",
  "cardholder.kyc.updated",
  "balance.low"
]

Response

Webhook config updated

​
success
enum<boolean>
required
Available options:
true