Skip to main content

Bring Your Own Key (BYOK)

By default, AI analysis runs through MailPrism. Bring Your Own Key (BYOK) lets you connect your own provider account instead, so analysis is billed to you directly and runs against your own rate limits.

Supported providers​

ProviderStatus
OpenAIAvailable
Anthropic (Claude)Available

These are the only providers you can bring a key for today. Other providers are not yet available for BYOK.

Tier requirement

BYOK is available on higher plans. If your plan doesn't include it, the OpenAI and Anthropic integrations show an Upgrade prompt. See Billing & Plans for what your plan includes.

What changes when you use BYOK​

When a key is configured for a provider:

  • AI operations for that provider run on your account and your rate limits.
  • You're billed directly by OpenAI or Anthropic at their rates.
  • MailPrism's platform AI credits are not consumed for those operations.

Your key is encrypted at rest and never logged or exposed.

Adding a key​

  1. Go to Settings → Integrations.
  2. Choose OpenAI or Anthropic.
  3. Click to add a key, paste your API key, and save. MailPrism validates it for you.

Get your key from the provider:

Once saved, the integration shows the key's status (Valid, Pending, or Invalid), when it was added, when it was last tested, and how many requests it's handled.

Managing a key​

From the provider's integration page you can:

  • Test — re-validate the key against the provider.
  • Replace — swap in a new key.
  • Remove — delete the key. After removal, MailPrism falls back to platform credits for that provider's operations.
Keep your key secure

Treat your API key like a password. Never share it or paste it into client-side code. You can revoke and regenerate keys anytime from your provider's console.

Seeing what your key is doing​

The Analytics page tracks AI operations, tokens, and cost, and shows what share of operations used your own keys versus the platform. See AI usage & cost for the details.