# Mixmax

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/mixmax

## Actions

### 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 group (`group_id`, text, required): The contact group. Pick one, or give its id from an earlier step.
- Contact ID (`contact_id`, text): The contact to add. Give this or an email address, not both.
- Email address (`email`, text): The address to add. Give this or a contact ID, not both.

**Outputs**

- `added` (true/false): Always true once added
- `contact` (object): The contact now in the group
- `group_id` (text): The group

**Example output**

```json
{
  "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 address (`email`, text, required): The email address.

**Outputs**

- `added` (true/false): Always true once added
- `email` (text): The address unsubscribed

**Example output**

```json
{
  "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 address (`email`, text, required): The email address.
- Name (`name`, text): The person's full name.
- Custom fields (`custom_fields`, object): 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**

- `contact` (object): The contact

**Example output**

```json
{
  "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 name (`name`, text, required): What to call the group.

**Outputs**

- `group` (object): The contact group

**Example output**

```json
{
  "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**

- To (`to`, list, required): Who to email, one address per row.
- Cc (`cc`, list): Addresses to copy, one per row.
- Bcc (`bcc`, list): Addresses to blind copy, one per row.
- Subject (`subject`, text): The subject line.
- Message (`body`, text): The message as plain text or HTML. Mixmax adds your signature, and its own 'Sent with Mixmax' line unless your plan removes it.
- Track opens (`tracking_enabled`, text): Tell me when it is opened. Leave blank to use your Mixmax default. One of: `yes`, `no`.
- Track link clicks (`link_tracking_enabled`, text): Tell me when a link is clicked. Leave blank to use your Mixmax default. One of: `yes`, `no`.
- Send me notifications (`notifications_enabled`, text): Notify me of activity on it. Leave blank to use your Mixmax default. One of: `yes`, `no`.

**Outputs**

- `message` (object): The message

**Example output**

```json
{
  "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 ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.

**Outputs**

- `contact_id` (text): The contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "contact_id": "64f0c0ffee0000000000a001",
  "deleted": true
}
```

### Delete contact group

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

**Inputs**

- Contact group (`group_id`, text, required): The contact group. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `group_id` (text): The contact group deleted

**Example output**

```json
{
  "deleted": true,
  "group_id": "64f0c0ffee0000000000b001"
}
```

### Delete message

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

**Inputs**

- Message ID (`message_id`, text, required): The message's id, from 'Create message', 'List messages' or an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `message_id` (text): The message deleted

**Example output**

```json
{
  "deleted": true,
  "message_id": "x5w7FHoxdkm57OOVC"
}
```

### Get contact

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

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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 ID (`message_id`, text, required): The message's id, from 'Create message', 'List messages' or an earlier step.

**Outputs**

- `message` (object): The message

**Example output**

```json
{
  "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**

- Snippet (`snippet_id`, text, required): The snippet. Pick one, or give its id from 'List snippets'.

**Outputs**

- `snippet` (object): The snippet

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `groups` (list): The contact groups
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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**

- Search (`search`, text): Only contacts whose name or email contains this.
- Page size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many on this page
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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 group (`group_id`, text, required): The contact group. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `contacts` (list): The contacts in the group
- `count` (number): How many on this page
- `group_id` (text): The group they are in
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `emails` (list): The sent emails
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one
- `stats` (object): Totals across your sent emails

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_next` (true/false): Whether there is another page
- `meeting_types` (list): The meeting types
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_next` (true/false): Whether there is another page
- `messages` (list): The messages
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one
- `snippets` (list): The snippets

**Example output**

```json
{
  "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 size (`limit`, number): How many to return, 1 to 100. From 1 to 100.
- Next page cursor (`next_cursor`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_next` (true/false): Whether there is another page
- `next_cursor` (text): Pass as 'next_cursor' for the next page; empty on the last one
- `unsubscribes` (list): The unsubscribed addresses

**Example output**

```json
{
  "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 group (`group_id`, text, required): The contact group. Pick one, or give its id from an earlier step.
- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.

**Outputs**

- `contact_id` (text): The contact removed
- `group_id` (text): The group
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "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 address (`email`, text, required): The email address.

**Outputs**

- `email` (text): The address taken off
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "email": "jo@example.com",
  "removed": true
}
```

### Rename contact group

Change a contact group's name.

**Inputs**

- Contact group (`group_id`, text, required): The contact group. Pick one, or give its id from an earlier step.
- New name (`name`, text, required): What to call the group now.

**Outputs**

- `group` (object): The contact group

**Example output**

```json
{
  "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 ID (`message_id`, text, required): The message's id, from 'Create message', 'List messages' or an earlier step.

**Outputs**

- `message` (object): The message as sent
- `message_id` (text): The message sent
- `sent` (true/false): Always true once Mixmax accepts it

**Example output**

```json
{
  "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 ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.
- New email address (`email`, text): Replace the contact's email address.
- Name (`name`, text): The person's full name.
- Custom fields (`custom_fields`, object): 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**

- `contact` (object): The contact

**Example output**

```json
{
  "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 ID (`message_id`, text, required): The message's id, from 'Create message', 'List messages' or an earlier step.
- To (`to`, list): Who to email, one address per row. Blank keeps the current recipients.
- Cc (`cc`, list): Addresses to copy, one per row.
- Bcc (`bcc`, list): Addresses to blind copy, one per row.
- Subject (`subject`, text): The subject line.
- Message (`body`, text): The message as plain text or HTML. Mixmax adds your signature, and its own 'Sent with Mixmax' line unless your plan removes it.
- Track opens (`tracking_enabled`, text): Tell me when it is opened. Leave blank to use your Mixmax default. One of: `yes`, `no`.
- Track link clicks (`link_tracking_enabled`, text): Tell me when a link is clicked. Leave blank to use your Mixmax default. One of: `yes`, `no`.
- Send me notifications (`notifications_enabled`, text): Notify me of activity on it. Leave blank to use your Mixmax default. One of: `yes`, `no`.

**Outputs**

- `message` (object): The message

**Example output**

```json
{
  "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"
  }
}
```
