Custom Domains

Receive webhooks on your own domain instead of listen.catchhook.app. Your webhook providers see your branded URL, and you maintain full control over the endpoint address.

Requires Business plan.

Setting up a custom domain

1. Go to Account Settings → Custom Domains.
2. Enter your domain (e.g., webhooks.yourcompany.com).
3. Click Add Domain.

CatchHook will provide a DNS TXT record for verification.

DNS configuration

Add two DNS records at your domain registrar:

1. CNAME record (routing)

Point your webhook subdomain to CatchHook:

2. TXT record (verification)

Prove domain ownership:

The exact TXT record value is shown in your Custom Domains settings after adding the domain.

Verification

Once DNS records are configured:

1. CatchHook automatically checks every 5 minutes for up to 48 hours.
2. You can also click Re-check to trigger verification immediately.
3. Once verified, SSL is automatically provisioned.

DNS changes can take up to 48 hours to propagate. Most providers propagate within 15 minutes.

How routing works

Requests to your custom domain are routed to the endpoint identified in the URL path:

• https://webhooks.yourcompany.com/ep_abc123 → Routes to the specific endpoint by prefix ID.
• https://webhooks.yourcompany.com/my-custom-id → Routes to the endpoint with custom ID my-custom-id.
• https://webhooks.yourcompany.com/ep_abc123/extra/path → Routes to the endpoint, with /extra/path preserved.

An endpoint identifier (prefix ID or custom ID) is required in the URL path. Requests to the root path (/) without an identifier will return a 404.

For example, the branded version of the URL does not include /hooks:

https://webhooks.yourcompany.com/ep_abc123

SSL

SSL certificates are automatically provisioned and renewed. No configuration needed on your end.

Removing a domain

Click Remove next to any domain in Custom Domains settings. The domain immediately stops accepting webhook traffic.

Updating webhook providers

After verification, update your webhook providers to use the new URL:

# Before
https://listen.catchhook.app/hooks/ep_abc123

# After
https://webhooks.yourcompany.com/ep_abc123

Both URLs continue to work — the original CatchHook URL is never disabled.