AI Connections

What AI Connections Are

AI connections let Mailrith use your own AI provider account for drafting email and automation content. Mailrith stores the connection, assigns it to workspaces, and lets each workspace choose a default connection and model.

Mailrith supports OpenAI, Claude, and OpenRouter for AI writing connections. OpenRouter can be connected either with an API key or through the OpenRouter OAuth flow when that option is available.

AI connections are a Pro feature. On a free workspace, the AI Connections page shows upgrade guidance instead of the full settings panel. If you need to enable the feature first, review Billing and Plans.

Create an AI Connection

1. Click AI Connections in the left sidebar.
2. Click Create AI Connection.
3. In the connection drawer, choose Provider: OpenAI, Claude, or OpenRouter.
4. If you choose OpenRouter, choose Connection Method: API Key or OAuth.
5. Enter a clear Connection Name so teammates can recognize it later.
6. For API key connections, paste the provider key into OpenAI API Key, Claude API Key, or OpenRouter API Key.
7. For OpenRouter OAuth, click Continue to OpenRouter and finish the authorization flow.
8. Use Workspace Access to select the workspaces that are allowed to use this connection.
9. Click Connect OpenAI, Connect Claude, or Connect OpenRouter, depending on the provider.

Use a clear name such as "Company OpenAI Production" or "Agency OpenRouter Shared." A good name helps teammates pick the right connection and helps owners know which provider account is being billed.

Workspace Defaults

After creating a connection, choose a default connection and model for each workspace where you want to use AI writing. The default is what Mailrith preselects when someone opens AI Writing in a broadcast, sequence, or automation.

1. On the AI Connections page, scroll to Workspace AI Writing Defaults.
2. Find the workspace row you want to configure.
3. Choose the default connection in Default Connection.
4. Choose the default model in Default Model.
5. Click Save in the defaults area.

Defaults are workspace-specific. This matters when one Mailrith account manages multiple brands or clients. Each Workspace can use a different provider account, different model, or no AI default at all.

If you remove a workspace from a connection, Mailrith clears defaults that pointed to that connection so the workspace does not keep using something it can no longer access.

Connection Statuses

• Active: Mailrith can use the connection for AI drafting.
• Needs attention: recent provider failures mean the connection should be reviewed. Common causes include invalid credentials, expired authorization, quota problems, or repeated provider errors.
• Revoked: the connection is no longer usable. Revoked rows stay visible for history, but they are read-only and cannot be selected for new defaults.

A connection can become Needs attention when the provider rejects requests. Repair it by editing the connection, updating the API key, or reconnecting the OAuth provider.

Repair, Delete, and Use Safely

If AI drafting fails inside a broadcast, sequence, or automation, Mailrith can link you back to the AI Connections page with the affected connection ready to repair. After repairing, return to the draft and try again.

Deleting a connection removes it from use and clears workspace defaults that pointed to it. Existing email content that was already generated remains in your drafts because it is normal email content after you apply it.

• Use provider keys that belong to the organization, not a temporary personal account.
• Assign connections only to workspaces that are allowed to use that provider account.
• Review provider billing and usage outside Mailrith so you understand AI costs.
• Do not paste provider keys into campaign copy, support chats, or shared documents.