Skip to main content
POST
/
api
/
webhook
/
create-webhook
curl -X POST 'https://crypto-api.yativo.com/api/webhook/create-webhook' \
  -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": true,
  "message": "Webhook created successfully",
  "data": {
    "_id": "whk_67e91cbe7747bdb0ba25abcd",
    "webhook_name": "My Webhook",
    "webhook_url": "https://your-app.com/webhooks/yativo",
    "account_id": "acc_6615c3b2e55d9ff7bc0a5678",
    "user_id": "usr_6615c3a1e55d9ff7bc0a1234",
    "receive_all_events": true,
    "status": "active",
    "createdAt": "2026-03-28T10:00:00.000Z"
  }
}
​
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-webhook' \
  -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": true,
  "message": "Webhook created successfully",
  "data": {
    "_id": "whk_67e91cbe7747bdb0ba25abcd",
    "webhook_name": "My Webhook",
    "webhook_url": "https://your-app.com/webhooks/yativo",
    "account_id": "acc_6615c3b2e55d9ff7bc0a5678",
    "user_id": "usr_6615c3a1e55d9ff7bc0a1234",
    "receive_all_events": true,
    "status": "active",
    "createdAt": "2026-03-28T10:00:00.000Z"
  }
}