Webhook Triggers

Overview

Webhooks allow external systems to receive notifications when events occur in SuitePortal.

Available Events

Sync Events

• sync.started — Sync process began
• sync.completed — Sync finished successfully
• sync.failed — Sync encountered error

Payment Events

• payment.created — New payment received
• payment.failed — Payment processing failed
• payment.refunded — Payment refunded

User Events

• user.created — New user added
• user.invited — Invitation sent

Configuration

Create Webhook

1. Navigate to Settings > Webhooks
2. Click Add Webhook
3. Enter endpoint URL
4. Select events to subscribe
5. Save

Webhook Payload

{
  "event": "payment.created",
  "timestamp": "2025-01-03T12:00:00Z",
  "data": {
    "paymentId": "pay_123",
    "amount": 1500.00,
    "invoiceId": "inv_456"
  }
}

Security

Signature Verification

Verify webhook authenticity:

1. Extract signature from header
2. Compute expected signature
3. Compare signatures

IP Allowlisting

Optionally restrict webhook sources by IP.

Retry Policy

Failed webhooks are retried:

• 3 retry attempts
• Exponential backoff
• Alerts after final failure