Skip to main content
POST
/
api
/
webhook
/
create
curl -X POST 'https://crypto-api.yativo.com/api/webhook/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["transaction.confirmed", "transaction.failed", "swap.completed"],
    "description": "Production webhook for transaction events"
  }'

{
  "status": "success",
  "message": "Webhook created successfully",
  "data": {
    "webhook_id": "wbh_01HX9KZMB3F7VNQP8R2WDGT4ET",
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["transaction.confirmed", "transaction.failed", "swap.completed"],
    "description": "Production webhook for transaction events",
    "secret": "whsec_01HX9KZMB3F7VNQP8R2WDGT4EU",
    "status": "active",
    "created_at": "2026-03-26T12:00:00Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
url
string
required
The HTTPS URL that will receive webhook POST requests.
​
events
array
required
Array of event types to subscribe to. Example events:
  • transaction.confirmed
  • transaction.failed
  • swap.completed
  • card.transaction.completed
  • iban.activated
​
description
string
required
A human-readable description of this webhook’s purpose.
curl -X POST 'https://crypto-api.yativo.com/api/webhook/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["transaction.confirmed", "transaction.failed", "swap.completed"],
    "description": "Production webhook for transaction events"
  }'

{
  "status": "success",
  "message": "Webhook created successfully",
  "data": {
    "webhook_id": "wbh_01HX9KZMB3F7VNQP8R2WDGT4ET",
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["transaction.confirmed", "transaction.failed", "swap.completed"],
    "description": "Production webhook for transaction events",
    "secret": "whsec_01HX9KZMB3F7VNQP8R2WDGT4EU",
    "status": "active",
    "created_at": "2026-03-26T12:00:00Z"
  }
}