inbound Webhook Endpoint Provisioning (Delivery)

inbound Webhook Endpoint Provisioning (Delivery)

1. 01

   Verify the client domain in the inbound dashboard by adding the MX records the vendor supplies

   Domain verification must complete before any address on that domain can receive mail. Confirm the plan tier covers the domain count: Pro allows 50 domains, Growth allows 300, and Scale lists unlimited domains.

2. 02

   Generate a scoped API key for the client build

   Keep one key per client so a revoked credential never touches another retainer. The REST API and TypeScript SDK both authenticate with this key.

3. 03

   Create the webhook endpoint and register its URL

   Inbound delivers each inbound message as structured JSON containing headers, text, HTML, and attachments. Point the endpoint at the client's application or automation layer, not a shared agency listener.

4. 04

   Configure guard rules for address routing

   Route named addresses such as support@ or billing@ to dedicated endpoints, and decide whether unmatched addresses fall through to catch-all. Higher plans add AI-evaluated rules for classification before routing.

5. 05

   Confirm threaded reply handling

   Check that In-Reply-To and References headers survive parsing so replies land inside the original thread rather than spawning new conversations in the client's inbox.

6. 06

   Send test messages to every configured address

   Fire one message per route plus one to an unmatched address to prove catch-all behaves as documented. Inspect the JSON payload for header, body, and attachment fidelity.

7. 07

   Hand the endpoint contract to the client's developer

   Document the webhook URL, expected payload shape, and the API key rotation path. Inbound has no no-code UI for end clients, so the receiving side needs someone who can read the JSON and maintain the endpoint.

8. 08

   Record the mailbox and domain counts against the plan ceiling

   Log current usage beside the tier limit so the next retainer renewal flags an upgrade before inbound starts rejecting mail. The entry tier covers 5,000 emails per month at $4 monthly.