Account Settings

Account settings control your branding, API tokens, team members, and integrations. Access them from Account Settings in the sidebar.

Branding (Pro and Business)

Customize how your webhook URLs look by configuring a namespace or subdomain.

Namespace

A namespace prefixes your custom endpoint IDs:

https://listen.catchhook.app/hooks/acme.checkout

Set your namespace in Account Settings under the Branding section.

Subdomain

A subdomain gives you a fully branded URL:

https://acme.catchhook.app/hooks/checkout

Configure your subdomain in Account Settings. Only one branding method (namespace or subdomain) can be active at a time.

Workspaces (Business)

Workspaces partition your account into isolated environments. Each workspace has its own endpoints, API tokens, notification channels, and Slack integrations.

• Business plans include 3 workspaces, with add-on packs available.
• Pro plans use a single implicit workspace (no workspace management UI).

Manage workspaces from the Workspaces section in Account Settings. See Workspaces for full details.

API tokens

API tokens authenticate the CLI and API requests. Tokens can be scoped to an account (access all workspaces) or a workspace (access only that workspace's resources).

• Account-scoped tokens — created in the Account API Tokens section of Account Settings. These have access to all workspaces and resources in the account.
• Workspace-scoped tokens — created from a workspace's management page. These only access the specific workspace's resources.

Creating a token

1. For account tokens: go to Account Settings and click Create API Token under Account API Tokens.
2. For workspace tokens: go to the workspace management page and click Create API Token.
3. The token is displayed once — copy it and store it securely.

Token scopes

Token sources

• User — created manually in Account Settings or workspace management.
• CLI — created automatically during CLI authentication (account-scoped, expires after 30 days).

Revoking a token

Click the revoke button next to any token. Revoked tokens stop working immediately.

Slack

Connect your Slack workspace to CatchHook for notifications, slash commands, and activity recaps. The Slack integration uses a proper Slack App (OAuth) — no manual webhook URLs. Slack integrations are now managed per workspace.

Connecting a Slack workspace

1. Go to the workspace management page (click Manage next to a workspace in Account Settings).
2. In the Slack Integrations section, click Add to Slack.
3. Authorize CatchHook in the Slack OAuth flow.
4. The Slack workspace appears in the connected list for that workspace.

Each CatchHook workspace can be connected to one Slack workspace. If you connect Slack again for that workspace, CatchHook updates that workspace's active Slack App installation.

Default channel

Pick a default Slack channel for account recaps and as the pre-selected channel when configuring new notification channels. The channel picker queries Slack directly — you can also test the bot's connectivity from here.

Account recaps

Enable periodic activity summaries posted to your default Slack channel:

• Daily — every morning at 9:00 AM UTC.
• Weekly — every Monday morning at 9:00 AM UTC.

Slash commands

Once connected, use /catchhook in Slack:

App Home tab

Open the CatchHook app in Slack to see a summary of your endpoints with health status and quick links to CatchHook.

Team members

Account owners and admins can invite account members directly from Account Settings:

1. Enter the person's email address.
2. Choose a role: Owner, Admin, or Member.
3. Click Invite.

Pending invitations can be resent or cancelled. Accepted members appear in the member list where you can change their role or remove them.

Roles

Account owners and admins are global overrides across all workspaces and teams.

Custom domains (Business)

Receive webhooks on your own domain (e.g., webhooks.yourcompany.com). See Custom Domains for full setup instructions.

Outbound webhooks (Business)

Have CatchHook notify your systems when events occur — webhook received, forwarding failed, alert triggered, etc. See Outbound Webhooks for details.

Profile settings

Your personal profile (name, timezone, digest preferences) is separate from account settings. Access it from Profile in the sidebar.

Digest preferences

Configure email digests that summarize webhook activity:

• Frequency — daily, weekly, or never.
• Days — which days to receive the digest.
• Time — preferred delivery time in your timezone.