Documentation

Core Concepts

Integration Lifecycle: Prepare, Verify, Activate

The three-step model used by integrations before they can receive production deliveries.

1 min readUpdated February 24, 2026Edit this page

Integrations in MailHook generally pass through three states.

1) Prepare

A configuration record is created with required fields and secure credentials.

2) Verify

Provider-specific ownership checks are completed when required.

Examples:

  • WhatsApp OTP verification.
  • Telegram bot linking.
  • Push subscription resolution.

3) Activate

Only active integrations are available for routing in production.

Testing recommendations

  • Run integration tests before attaching high-volume routings.
  • Validate credentials expiry and provider-side limits.
  • Keep one sandbox integration for safe replay tests.