Skip to main content
POST
https://services-staging.bitmama.io/api
/
v1
/
partner
/
profile
/
webhook
curl -X POST https://services-staging.bitmama.io/api/v1/partner/profile/webhook \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://api.acme.com/webhooks/bitmama"
  }'

{
  "status": "success",
  "message": "Webhook endpoint configured",
  "data": {
    "webhookUrl": "https://api.acme.com/webhooks/bitmama",
    "webhookSecret": "whsec_abc123def456..."
  }
}
Set the URL where you want to receive webhook events. Returns a webhookSecret for signature verification.
​
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
​
webhookUrl
string
required
HTTPS URL to receive webhook events. Max 2048 characters.
curl -X POST https://services-staging.bitmama.io/api/v1/partner/profile/webhook \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://api.acme.com/webhooks/bitmama"
  }'

{
  "status": "success",
  "message": "Webhook endpoint configured",
  "data": {
    "webhookUrl": "https://api.acme.com/webhooks/bitmama",
    "webhookSecret": "whsec_abc123def456..."
  }
}
Store the webhookSecret securely — it’s only returned when you set or update your webhook URL. You’ll need it to verify webhook signatures.