Navigation

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:

Type Name Value
CNAME webhooks.yourcompany.com listen.catchhook.app

2. TXT record (verification)

Prove domain ownership:

Type Name Value
TXT _catchhook-verify.webhooks.yourcompany.com catchhook-verify-abc123...

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 as follows:

  • https://webhooks.yourcompany.com/ep_abc123 → Routes to the specific endpoint by prefix ID.
  • https://webhooks.yourcompany.com/ → Routes to your account's first (oldest) endpoint.
  • https://webhooks.yourcompany.com/any/path → Routes to your first endpoint with the original path preserved.

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.