Skip to main content

Mixmax REST API

How to create your personal Mixmax API key or, as an admin, API keys for workspace members, plus REST API documentation, rate limits, and developer resources.

Mixmax REST API is available on the following plans:

  • Mixmax Pro

  • Meeting Copilot

  • Inbox Copilot

  • Engagement Copilot

  • Mixmax Suite

  • Mixmax for Teams

  • Growth + CRM (Legacy)

  • Enterprise (Legacy)

Please check our pricing page for more information.

Excited to create custom apps and connect them with Mixmax? Our powerful API makes it easy to build tailored integrations that enhance your workflow.

Get started by visiting the Mixmax Developer Portal. You'll find detailed documentation, code examples, and everything you need to bring your ideas to life.

What you can do with the API

The REST API works with your existing Mixmax data. You can list and search Sequences, add recipients to Sequences, cancel recipients so they stop getting emails, and manage templates (snippets), Rules, and messages.

There are two kinds of Mixmax API keys:

  • Personal API key: You create this in your own settings page. It acts as you and works with the full REST API.

  • Member API keys: A workspace admin creates these in the Admin Center on behalf of a workspace member. Each key acts as that member and works with the endpoints listed under Authentication in the Developer Portal, within the permissions the admin chooses.


How to create your personal Mixmax API key

  1. Log in to app.mixmax.com.

  2. Go to My Settings > Integrations > API.

  3. Click Create Mixmax API Token.

Integrations settings

Your personal API key is tied to your own account. Keep it secure and never share it publicly.

Creating a new personal API key replaces your old one. Any integration still using the old key will stop working until you update it with the new key.


How to create API keys for workspace members (admins only)

Workspace admins can create API keys that act on behalf of a specific workspace member. This lets an integration, such as a custom CRM app, add recipients to Sequences as different team members, without anyone having to share their personal API key.

Member API keys are separate from each member's personal API key, so creating one doesn't affect any integration the member already uses.

  1. Log in to app.mixmax.com.

  2. Go to Admin center > API keys.

  3. Click Create API key.

API keys page

In the Create API key window:

Create API key window
  1. Under Workspace member, select the member this API key will act on behalf of.

  2. Under API key name, describe what the key is used for (for example, SF Custom Build). Names don't need to be unique, and you can change them later.

  3. Under Permissions, select the minimum access the integration needs. You can change permissions later.

  4. Click Create API key.

  5. Copy the API key right away and store it somewhere secure. It's shown only once and can't be retrieved later.

Name each key after the integration it's used for, not the member's email address. The member is already shown next to each key on the API keys page, and a descriptive name makes it easy to tell what a key is used for.

Permissions

Each member API key only has the permissions you select. The Sequence permissions are:

  • Read sequences: View Sequences and the information needed to select recipients.

  • Manage sequences: Make changes to the member's Sequences.

  • Enroll recipients: Add recipients to a Sequence and start their enrollment.

For example, an integration that lets reps pick a Sequence and add a contact to it needs Read sequences and Enroll recipients.

For the other permissions and the endpoints each one covers, see Authentication in the Developer Portal.

Manage member API keys

The API keys page lists every member API key in your workspace, with its member, name, permissions, and the date it last changed. A member can have more than one API key, for example, one per integration.

Use the icons in the Actions column to:

  • Edit (pencil icon): Change the key's name or permissions.

  • Rotate (arrows icon): Generate a new key value, for example, if it may have been exposed. Update your integration with the new value.

  • Revoke (trash icon): Delete the key. It stops working immediately.

If you remove a member from your workspace, their member API keys stop working immediately.


FAQ

Can I create a Sequence with the API?

No. Build the Sequence in the Mixmax app first or via MCP, then use the API to add recipients to it.

Does the API have rate limits?

Yes. The Mixmax REST API is optimized for lightweight, real-time interactions. It's not intended for bulk exports, large-scale data warehousing, or other high-volume sync jobs.

As a result, it has a rate limit of 120 requests per minute per user, and some endpoints have lower limits. These limits are fixed and cannot be increased, so plan accordingly. If you reach these limits, please respect the Retry-After header message. For details, see Rate limiting in the Developer Portal.

What's the difference between a personal API key and a member API key?

You create your personal API key yourself, and it acts on your behalf across the full REST API. You can have one personal API key at a time. A workspace admin creates member API keys for a specific member; they work with a subset of the REST API and are limited to the permissions the admin selects. A member can have several member API keys, and they don't replace or change the member's personal API key.

Which parts of the API can member API keys use?

Member API keys work with a subset of the REST API. Authentication in the Developer Portal lists which endpoints they can use, and each endpoint page specifies the required permission. Requests to other endpoints, such as contacts, messages, or templates, are rejected. To use other endpoints, use a personal API key.

Can I see a member API key again after creating it?

No. For security, the key is shown only once, when you create it. If you lose it, rotate the key to generate a new value and update your integration.

Did this answer your question?