Overview

This page provides detailed definitions for each supported Webhooks topic. Topics are logical groupings of related events that clients can subscribe to for real-time updates. Understanding these definitions helps ensure your subscriptions align with your business needs.

How Topics Work

Each topic represents a category of events tied to a specific entity (e.g., Transfers, Transactions). Clients can subscribe at:

Topic-level: Receive all events under a topic.
Event-level: Subscribe to specific event types.
Combination: Mix topic and event-level subscriptions for granular control.

Topic Naming Convention

Webhook topics follow this format:

<client>.<environment>.<topic_name>

Example: neal.abc-enterprises.sandbox.transfer

Topic names are predefined by Newline and cannot be customized by clients.

Topic Definitions

Transfer

Transfer Initiated: A transfer has been created.
Transfer Status Changed: The status of a transfer has been updated.
RTP Settlement: An instant payment transfer has reached settlement.

Transaction

Transaction Created: A transaction record has been generated.
Transaction Status Updated: The transaction status has changed.

Synthetic Account

Account Created: A synthetic account has been created.
Status Changed: The account status has changed.
Name Updated: The account name has been updated.

Virtual Reference Numbers (VRNs)

VRN Created: A new VRN has been issued.
Instant Payment Rail Registration Status Changed: The registration status has changed.

Customer (Beta)

Status Changed: A customer’s status has changed.
Locked/Unlocked: Indicates account access changes.

Debit Card (Beta)

Requested/Issued: A card has been requested or issued.
Status Updated: The card status has changed.
Reissued/Locked/Unlocked: Lifecycle and access events.
PIN Events: PIN changed, staging failed, or commit failed.

Example Payloads

Each webhook event includes:

event_type (e.g., created, status_change)
details object with relevant data
Unique event_id for idempotency
HMAC signature in the X-Signature header

Example:

{
  "event_type": "created",
  "details": {
    "customer_uid": "ab12cd34ef56gh78",
    "transfer_uid": "Zb12cd34ef56gh7X",
    "usd_transfer_amount": "321.00"
  }
}