Going to production

A launch checklist: live keys, scopes, webhooks, retries and monitoring before real users get messages.

Applies to

Production env

1# Placeholder: Fernway is a fictional API.
2# Live keys start with fw_live_. Keep them on the server only.
3export FERNWAY_API_KEY="fw_live_xxxxxxxxxxxxxxxx"
4export FERNWAY_WEBHOOK_SECRET="whsec_xxxxxxxxxxxxxxxx"
5export FERNWAY_VERSION="2026-10-01"

Launch checklist

Swap test keys for a live key scoped to only what the service needs.
Pin Fernway-Version so a new release cannot change behaviour under you.
Register a live webhook endpoint and verify signatures.
Send an Idempotency-Key on every POST and retry 429 and 5xx with backoff.
Subscribe to the status page and the changelog feed.

Monitoring

Alert on a rising failed rate per channel and on webhook endpoints returning errors. Fernway disables an endpoint after 3 days of continuous failures.

Sender setup

Verify your sending domain for email and register sender IDs where carriers require it. Approval times vary by country.

Placeholder API

Fernway is a fictional product used to show how this template works. Replace these docs with your own in the CMS.

← Migrating v1 to v2