> ## Documentation Index
> Fetch the complete documentation index at: https://helloluciallc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Routing Strategy

<Note>
  Lucia webhook routing is intentionally environment-bound so live provider signals do not drift into the wrong runtime.
</Note>

***

## Current Truth

Twilio and Postmark webhook routing currently targets Development unless intentionally switched.

Current Development API base:

```text theme={"dark"}
https://api-dev.hellolucia.ai
```

Current webhook intake path:

```text theme={"dark"}
/webhooks/maintenance
```

Staging exists for validation after an intentional promotion or provider-routing change. Production webhook routing is future and must not be implied as active by Canon unless explicitly documented.

***

## Provider Routing

Current provider routing:

```text theme={"dark"}
Twilio SMS/MMS -> api-dev
Twilio WhatsApp -> api-dev
Postmark inbound email -> api-dev
```

Routing to Staging requires an intentional switch. Localhost testing requires an intentional local tunnel such as ngrok.

***

## Canon Rule

When webhook routing changes, Canon must record:

```text theme={"dark"}
provider
source channel
target environment
target API base
webhook path
validation status
rollback path
```

***

## See Also

* [11 - Domains and Live Routing](/lucia/infrastructure/domains-and-live-routing)
* [06 - Twilio (SMS WhatsApp Voice)](/lucia/infrastructure/twilio-sms-whatsapp-voice)
* [07 - Postmark (Email Inbound)](/lucia/infrastructure/postmark-email-inbound)
* [01 - Maintenance Workflow](/lucia/operations/maintenance-workflow)
