Mixmax

App · 25 actions

Work with your Mixmax email outreach: add and update contacts and contact groups, manage the unsubscribe list, draft and send emails from your own mailbox, read how sent emails performed, and use your saved snippets and meeting types.

Actions

ActionWhat it does
Add contact to groupPut a contact in a contact group, by the contact's id or by email address.
Add unsubscribePut an address on your unsubscribe list so Mixmax stops emailing it.
Create contactAdd a contact by email.
Create contact groupMake an empty contact group to collect contacts in.
Create messageMake a draft email from your connected mailbox.
Delete contactDelete a contact from Mixmax.
Delete contact groupDelete a contact group.
Delete messageDelete a draft or a message made through the Mixmax API.
Get contactGet one contact with their name, email and custom fields.
Get messageGet one message with its recipients, subject, body and tracking settings.
Get snippetGet one saved snippet with its full body as HTML.
List contact groupsList your contact groups.
List contactsList your Mixmax contacts, newest first, optionally only those whose name or email matches a search.
List contacts in groupList the contacts in one contact group.
List email activityList the emails you sent with Mixmax tracking, newest first, with opens, clicks, downloads, replies and bounces, plus totals across your emails.
List meeting typesList the meeting types people can book through your Mixmax calendar, with their length and booking link.
List messagesList the emails made through the Mixmax API, drafts and sent, newest first.
List snippetsList your saved email snippets (reusable templates) by title, without their bodies.
List unsubscribesList the addresses on your unsubscribe list, which Mixmax sequences never email.
Remove contact from groupTake a contact out of a contact group.
Remove unsubscribeTake an address off your unsubscribe list so it can be emailed again.
Rename contact groupChange a contact group's name.
Send messageSend a draft email from your connected Gmail or Outlook mailbox.
Update contactChange a contact's email, name or custom fields.
Update messageChange a draft's recipients, subject, body or tracking.

Add contact to group

Put a contact in a contact group, by the contact's id or by email address. An address Mixmax does not know yet is added as a new contact.

Inputs

Contact groupgroup_idtextRequired
The contact group. Pick one, or give its id from an earlier step.
Contact IDcontact_idtext
The contact to add. Give this or an email address, not both.
Email addressemailtext
The address to add. Give this or a contact ID, not both.

Outputs

addedtrue/false
Always true once added
contactobject
The contact now in the group
group_idtext
The group
Example output
{
  "added": true,
  "contact": {
    "_id": "64f0c0ffee0000000000a001",
    "contactId": "62d3f5800ae06975",
    "email": "jo@example.com",
    "lastSyncedAt": "2026-11-13T18:16:36.968Z",
    "meta": {
      "company": "Acme"
    },
    "name": "Jo Bloggs",
    "usedCount": 0,
    "userId": "64f0c0ffee0000000000a000"
  },
  "group_id": "64f0c0ffee0000000000b001"
}

Add unsubscribe

Put an address on your unsubscribe list so Mixmax stops emailing it.

Inputs

Email addressemailtextRequired
The email address.

Outputs

addedtrue/false
Always true once added
emailtext
The address unsubscribed
Example output
{
  "added": true,
  "email": "jo@example.com"
}

Create contact

Add a contact by email. If a contact with that email already exists, Mixmax updates it with the name and custom fields given.

Inputs

Email addressemailtextRequired
The email address.
Namenametext
The person's full name.
Custom fieldscustom_fieldsobject
Extra details to keep on the contact, such as company or title. Each field name with its value; fields already on the contact stay.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "_id": "64f0c0ffee0000000000a001",
    "contactId": "62d3f5800ae06975",
    "email": "jo@example.com",
    "lastSyncedAt": "2026-11-13T18:16:36.968Z",
    "meta": {
      "company": "Acme"
    },
    "name": "Jo Bloggs",
    "usedCount": 0,
    "userId": "64f0c0ffee0000000000a000"
  }
}

Create contact group

Make an empty contact group to collect contacts in.

Inputs

Group namenametextRequired
What to call the group.

Outputs

groupobject
The contact group
Example output
{
  "group": {
    "_id": "64f0c0ffee0000000000b001",
    "name": "Prospects",
    "userId": "64f0c0ffee0000000000a000"
  }
}

Create message

Make a draft email from your connected mailbox. Nothing is sent until you run 'Send message' on it.

Inputs

TotolistRequired
Who to email, one address per row.
Cccclist
Addresses to copy, one per row.
Bccbcclist
Addresses to blind copy, one per row.
Subjectsubjecttext
The subject line.
Messagebodytext
The message as plain text or HTML. Mixmax adds your signature, and its own 'Sent with Mixmax' line unless your plan removes it.
Track openstracking_enabledtext
Tell me when it is opened. Leave blank to use your Mixmax default.One of: yes, no.
Track link clickslink_tracking_enabledtext
Tell me when a link is clicked. Leave blank to use your Mixmax default.One of: yes, no.
Send me notificationsnotifications_enabledtext
Notify me of activity on it. Leave blank to use your Mixmax default.One of: yes, no.

Outputs

messageobject
The message
Example output
{
  "message": {
    "_id": "x5w7FHoxdkm57OOVC",
    "bcc": [],
    "body": "<p>Hello Jo</p>",
    "cc": [],
    "created": 1794593885450,
    "fileTrackingEnabled": false,
    "from": {
      "email": "me@example.com",
      "name": "Me"
    },
    "linkTrackingEnabled": true,
    "notificationsEnabled": false,
    "subject": "Quick question",
    "to": [
      {
        "email": "jo@example.com",
        "name": "Jo Bloggs"
      }
    ],
    "trackingEnabled": true,
    "updatedAt": 1794593885450,
    "userId": "64f0c0ffee0000000000a000"
  }
}

Delete contact

Delete a contact from Mixmax.

Inputs

Contact IDcontact_idtextRequired
The contact's id, from 'List contacts', 'Create contact' or an earlier step.

Outputs

contact_idtext
The contact deleted
deletedtrue/false
Always true once deleted
Example output
{
  "contact_id": "64f0c0ffee0000000000a001",
  "deleted": true
}

Delete contact group

Delete a contact group. The contacts in it stay in Mixmax.

Inputs

Contact groupgroup_idtextRequired
The contact group. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
group_idtext
The contact group deleted
Example output
{
  "deleted": true,
  "group_id": "64f0c0ffee0000000000b001"
}

Delete message

Delete a draft or a message made through the Mixmax API.

Inputs

Message IDmessage_idtextRequired
The message's id, from 'Create message', 'List messages' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
message_idtext
The message deleted
Example output
{
  "deleted": true,
  "message_id": "x5w7FHoxdkm57OOVC"
}

Get contact

Get one contact with their name, email and custom fields.

Inputs

Contact IDcontact_idtextRequired
The contact's id, from 'List contacts', 'Create contact' or an earlier step.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "_id": "64f0c0ffee0000000000a001",
    "contactId": "62d3f5800ae06975",
    "email": "jo@example.com",
    "lastSyncedAt": "2026-11-13T18:16:36.968Z",
    "meta": {
      "company": "Acme"
    },
    "name": "Jo Bloggs",
    "usedCount": 0,
    "userId": "64f0c0ffee0000000000a000"
  }
}

Get message

Get one message with its recipients, subject, body and tracking settings.

Inputs

Message IDmessage_idtextRequired
The message's id, from 'Create message', 'List messages' or an earlier step.

Outputs

messageobject
The message
Example output
{
  "message": {
    "_id": "x5w7FHoxdkm57OOVC",
    "bcc": [],
    "body": "<p>Hello Jo</p>",
    "cc": [],
    "created": 1794593885450,
    "fileTrackingEnabled": false,
    "from": {
      "email": "me@example.com",
      "name": "Me"
    },
    "linkTrackingEnabled": true,
    "notificationsEnabled": false,
    "subject": "Quick question",
    "to": [
      {
        "email": "jo@example.com",
        "name": "Jo Bloggs"
      }
    ],
    "trackingEnabled": true,
    "updatedAt": 1794593885450,
    "userId": "64f0c0ffee0000000000a000"
  }
}

Get snippet

Get one saved snippet with its full body as HTML.

Inputs

Snippetsnippet_idtextRequired
The snippet. Pick one, or give its id from 'List snippets'.

Outputs

snippetobject
The snippet
Example output
{
  "snippet": {
    "_id": "64f0c0ffee0000000000e001",
    "createdAt": 1794591049589,
    "name": "Follow up",
    "savedAt": 1794591049589,
    "source": "<p>Hello {{first name}}</p>",
    "title": "Follow up",
    "userId": "64f0c0ffee0000000000a000"
  }
}

List contact groups

List your contact groups.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
groupslist
The contact groups
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
Example output
{
  "count": 1,
  "groups": [
    {
      "_id": "64f0c0ffee0000000000b001",
      "name": "Prospects",
      "userId": "64f0c0ffee0000000000a000"
    }
  ],
  "has_next": false,
  "next_cursor": ""
}

List contacts

List your Mixmax contacts, newest first, optionally only those whose name or email matches a search.

Inputs

Searchsearchtext
Only contacts whose name or email contains this.
Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

contactslist
The contacts
countnumber
How many on this page
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
Example output
{
  "contacts": [
    {
      "_id": "64f0c0ffee0000000000a001",
      "contactId": "62d3f5800ae06975",
      "email": "jo@example.com",
      "lastSyncedAt": "2026-11-13T18:16:36.968Z",
      "meta": {
        "company": "Acme"
      },
      "name": "Jo Bloggs",
      "usedCount": 0,
      "userId": "64f0c0ffee0000000000a000"
    }
  ],
  "count": 1,
  "has_next": false,
  "next_cursor": ""
}

List contacts in group

List the contacts in one contact group.

Inputs

Contact groupgroup_idtextRequired
The contact group. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

contactslist
The contacts in the group
countnumber
How many on this page
group_idtext
The group they are in
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
Example output
{
  "contacts": [
    {
      "_id": "64f0c0ffee0000000000a001",
      "contactId": "62d3f5800ae06975",
      "email": "jo@example.com",
      "lastSyncedAt": "2026-11-13T18:16:36.968Z",
      "meta": {
        "company": "Acme"
      },
      "name": "Jo Bloggs",
      "usedCount": 0,
      "userId": "64f0c0ffee0000000000a000"
    }
  ],
  "count": 1,
  "group_id": "64f0c0ffee0000000000b001",
  "has_next": false,
  "next_cursor": ""
}

List email activity

List the emails you sent with Mixmax tracking, newest first, with opens, clicks, downloads, replies and bounces, plus totals across your emails.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
emailslist
The sent emails
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
statsobject
Totals across your sent emails
Example output
{
  "count": 1,
  "emails": [
    {
      "_id": "x5w7FHoxdkm57OOVC",
      "fromEmail": "me@example.com",
      "fromName": "Me",
      "lastEventAt": 1794593896000,
      "lastEventType": "sent",
      "numClicks": 0,
      "numDownloads": 0,
      "numOpens": 0,
      "recipients": [
        {
          "email": "jo@example.com",
          "name": "Jo Bloggs"
        }
      ],
      "sent": 1794593896000,
      "service": "gmail",
      "serviceMessageId": "1a1d621a7833a096",
      "serviceThreadId": "1a1d621a7833a096",
      "subject": "Quick question",
      "wasBounced": 0,
      "wasReplied": 0
    }
  ],
  "has_next": false,
  "next_cursor": "",
  "stats": {
    "bounced": 0,
    "clicked": 0,
    "delivered": 1,
    "opened": 0,
    "percentages": {
      "delivered": 100,
      "opened": 0
    },
    "recipients": 1,
    "replied": 0,
    "sent": 1
  }
}

List meeting types

List the meeting types people can book through your Mixmax calendar, with their length and booking link.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_nexttrue/false
Whether there is another page
meeting_typeslist
The meeting types
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
Example output
{
  "count": 1,
  "has_next": false,
  "meeting_types": [
    {
      "_id": "64f0c0ffee0000000000f001",
      "calendarIds": [
        "me@example.com"
      ],
      "createdAt": "2026-11-13T17:30:47.974Z",
      "durationMin": 30,
      "link": "30",
      "name": "30-minute Meeting",
      "type": "Personal",
      "updatedAt": "2026-11-13T17:30:47.974Z",
      "userId": "64f0c0ffee0000000000a000"
    }
  ],
  "next_cursor": ""
}

List messages

List the emails made through the Mixmax API, drafts and sent, newest first.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_nexttrue/false
Whether there is another page
messageslist
The messages
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
Example output
{
  "count": 1,
  "has_next": false,
  "messages": [
    {
      "_id": "x5w7FHoxdkm57OOVC",
      "bcc": [],
      "body": "<p>Hello Jo</p>",
      "cc": [],
      "created": 1794593885450,
      "fileTrackingEnabled": false,
      "from": {
        "email": "me@example.com",
        "name": "Me"
      },
      "linkTrackingEnabled": true,
      "notificationsEnabled": false,
      "subject": "Quick question",
      "to": [
        {
          "email": "jo@example.com",
          "name": "Jo Bloggs"
        }
      ],
      "trackingEnabled": true,
      "updatedAt": 1794593885450,
      "userId": "64f0c0ffee0000000000a000"
    }
  ],
  "next_cursor": ""
}

List snippets

List your saved email snippets (reusable templates) by title, without their bodies.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
snippetslist
The snippets
Example output
{
  "count": 1,
  "has_next": false,
  "next_cursor": "",
  "snippets": [
    {
      "_id": "64f0c0ffee0000000000e001",
      "createdAt": 1794591049589,
      "name": "Follow up",
      "savedAt": 1794591049589,
      "title": "Follow up",
      "userId": "64f0c0ffee0000000000a000"
    }
  ]
}

List unsubscribes

List the addresses on your unsubscribe list, which Mixmax sequences never email.

Inputs

Page sizelimitnumber
How many to return, 1 to 100.From 1 to 100.
Next page cursornext_cursortext
The 'next_cursor' from an earlier page, to get the page after it.

Outputs

countnumber
How many on this page
has_nexttrue/false
Whether there is another page
next_cursortext
Pass as 'next_cursor' for the next page; empty on the last one
unsubscribeslist
The unsubscribed addresses
Example output
{
  "count": 1,
  "has_next": false,
  "next_cursor": "",
  "unsubscribes": [
    {
      "_id": "64f0c0ffee0000000000c001",
      "createdAt": "2026-11-13T18:16:49.269Z",
      "email": "jo@example.com",
      "name": "Jo Bloggs",
      "orgId": "64f0c0ffee0000000000d001",
      "userId": "64f0c0ffee0000000000a000"
    }
  ]
}

Remove contact from group

Take a contact out of a contact group. The contact stays in Mixmax.

Inputs

Contact groupgroup_idtextRequired
The contact group. Pick one, or give its id from an earlier step.
Contact IDcontact_idtextRequired
The contact's id, from 'List contacts', 'Create contact' or an earlier step.

Outputs

contact_idtext
The contact removed
group_idtext
The group
removedtrue/false
Always true once removed
Example output
{
  "contact_id": "64f0c0ffee0000000000a001",
  "group_id": "64f0c0ffee0000000000b001",
  "removed": true
}

Remove unsubscribe

Take an address off your unsubscribe list so it can be emailed again.

Inputs

Email addressemailtextRequired
The email address.

Outputs

emailtext
The address taken off
removedtrue/false
Always true once removed
Example output
{
  "email": "jo@example.com",
  "removed": true
}

Rename contact group

Change a contact group's name.

Inputs

Contact groupgroup_idtextRequired
The contact group. Pick one, or give its id from an earlier step.
New namenametextRequired
What to call the group now.

Outputs

groupobject
The contact group
Example output
{
  "group": {
    "_id": "64f0c0ffee0000000000b001",
    "name": "Prospects",
    "userId": "64f0c0ffee0000000000a000"
  }
}

Send message

Send a draft email from your connected Gmail or Outlook mailbox. The email goes to its recipients at once, and a message can be sent only once.

Inputs

Message IDmessage_idtextRequired
The message's id, from 'Create message', 'List messages' or an earlier step.

Outputs

messageobject
The message as sent
message_idtext
The message sent
senttrue/false
Always true once Mixmax accepts it
Example output
{
  "message": {
    "_id": "x5w7FHoxdkm57OOVC",
    "bcc": [],
    "body": "<p>Hello Jo</p>",
    "cc": [],
    "created": 1794593885450,
    "fileTrackingEnabled": false,
    "from": {
      "email": "me@example.com",
      "name": "Me"
    },
    "linkTrackingEnabled": true,
    "notificationsEnabled": false,
    "subject": "Quick question",
    "to": [
      {
        "email": "jo@example.com",
        "name": "Jo Bloggs"
      }
    ],
    "trackingEnabled": true,
    "updatedAt": 1794593885450,
    "userId": "64f0c0ffee0000000000a000"
  },
  "message_id": "x5w7FHoxdkm57OOVC",
  "sent": true
}

Update contact

Change a contact's email, name or custom fields. Fields left blank stay as they are.

Inputs

Contact IDcontact_idtextRequired
The contact's id, from 'List contacts', 'Create contact' or an earlier step.
New email addressemailtext
Replace the contact's email address.
Namenametext
The person's full name.
Custom fieldscustom_fieldsobject
Extra details to keep on the contact, such as company or title. Each field name with its value; fields already on the contact stay.

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "_id": "64f0c0ffee0000000000a001",
    "contactId": "62d3f5800ae06975",
    "email": "jo@example.com",
    "lastSyncedAt": "2026-11-13T18:16:36.968Z",
    "meta": {
      "company": "Acme"
    },
    "name": "Jo Bloggs",
    "usedCount": 0,
    "userId": "64f0c0ffee0000000000a000"
  }
}

Update message

Change a draft's recipients, subject, body or tracking. Fields left blank stay as they are.

Inputs

Message IDmessage_idtextRequired
The message's id, from 'Create message', 'List messages' or an earlier step.
Totolist
Who to email, one address per row. Blank keeps the current recipients.
Cccclist
Addresses to copy, one per row.
Bccbcclist
Addresses to blind copy, one per row.
Subjectsubjecttext
The subject line.
Messagebodytext
The message as plain text or HTML. Mixmax adds your signature, and its own 'Sent with Mixmax' line unless your plan removes it.
Track openstracking_enabledtext
Tell me when it is opened. Leave blank to use your Mixmax default.One of: yes, no.
Track link clickslink_tracking_enabledtext
Tell me when a link is clicked. Leave blank to use your Mixmax default.One of: yes, no.
Send me notificationsnotifications_enabledtext
Notify me of activity on it. Leave blank to use your Mixmax default.One of: yes, no.

Outputs

messageobject
The message
Example output
{
  "message": {
    "_id": "x5w7FHoxdkm57OOVC",
    "bcc": [],
    "body": "<p>Hello Jo</p>",
    "cc": [],
    "created": 1794593885450,
    "fileTrackingEnabled": false,
    "from": {
      "email": "me@example.com",
      "name": "Me"
    },
    "linkTrackingEnabled": true,
    "notificationsEnabled": false,
    "subject": "Quick question",
    "to": [
      {
        "email": "jo@example.com",
        "name": "Jo Bloggs"
      }
    ],
    "trackingEnabled": true,
    "updatedAt": 1794593885450,
    "userId": "64f0c0ffee0000000000a000"
  }
}

On this page