> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://mammoth.io/docs/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown.

# Register an OAuth app for Sign in with Mammoth

> Register an OAuth app in Mammoth so people can connect their account with Sign in with Mammoth: name, redirect URIs, client ID and secret, and deleting an app.
>
> Applies to: Roles: Workspace Owners. Where: Workspace Settings › API Keys › OAuth apps

OAuth apps are "Apps that let people connect their Mammoth account with Sign in with Mammoth." You register them in **Workspace Settings** → **API Keys** → **OAuth apps**. Only Workspace Owners can register or delete apps; others see "You can't register or delete OAuth apps in this workspace. Contact the Workspace Owner."

The card lists each app with **Name**, **Client ID** (with a copy button), **Redirect URIs** and **Created**. With none, it shows "No OAuth apps registered yet."

## Register an app

1. Click **Register app** to open **Register OAuth app**.
2. Fill in the fields below.
3. Click **Register app**.
4. In **Save these now**, copy the **Client ID** and, for apps that aren't public, the **Client secret**. "The secret is shown only once. Store it securely."
5. Click **Done**.

| Field | Required | Notes |
| --- | --- | --- |
| **Name** | Yes | Up to 100 characters, for example "Acme Analytics" |
| **Redirect URIs** | Yes | At least one, up to 10. Use **Add redirect URI** for more |
| **Public app** | No | "No client secret. For desktop apps and CLIs." |
| **Description** | No | Under **Optional details**. Up to 500 characters |
| **Logo URL**, **Terms of service URL**, **Privacy policy URL** | No | Under **Optional details**. Each must be an `https://` URL |

The app's name, logo, terms and privacy links appear on the consent screen people see when they connect the app.

## Redirect URI rules

| Message | Rule |
| --- | --- |
| "Must be an https:// URL, or an http://localhost, http://127.0.0.1 or http://[::1] URL" | Use https, or a loopback address on your own machine |
| "Must not contain spaces, backslashes or *" | No wildcards |
| "Must not contain #" | No fragment |

## Delete an OAuth app

Click the delete icon on its row. "This permanently deletes the app and every user's connection to it stops working immediately."

## Limits

| Item | Limit |
| --- | --- |
| OAuth app **Name** | 100 characters |
| OAuth app **Redirect URIs** | 1 to 10 |
| OAuth app **Description** | 500 characters |

## Related

- [Create API keys and connect AI assistants](https://mammoth.io/docs/learn/workspace/api-keys/): tokens, MCP and connected apps.
- [Security](https://mammoth.io/docs/learn/workspace/security/): how tokens and sessions are protected.
- [Authentication](https://mammoth.io/docs/build/auth/): tokens, the SDK and CLI sign-in for developers.

---
Source: https://mammoth.io/docs/learn/workspace/oauth-apps.md · Updated: 2026-11-08