Create a notification

POST/notifications

Send a notification directly

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

dataobjectRequired

templatestringRequired

Returns

201 Created

The Notification object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/notifications' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
    "data": {},
    "template": "string"
  }'

Response201

{
  "attempts": 0,
  "body": "string",
  "channel": "string",
  "content_sha256": "string",
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "delivery_status": "string",
  "error": "string",
  "id": "ntf_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "next_attempt_at": "2026-09-17T14:30:00Z",
  "provider_ref": "string",
  "recipient_address": "string",
  "status": "string",
  "subject": "string",
  "template": "string",
  "template_version": "string"
}