Missive

App · 29 actions

Work with your Missive shared inbox: read and update conversations, post to them, send email and drafts, manage contacts, saved responses and tasks, and look up your people, teams and labels.

Actions

ActionWhat it does
Create contactAdd a contact to a contact book, with an email, phone number and company if you have them.
Create email draftSave an email draft in Missive for someone to review and send from the app.
Create postAdd a post to a conversation, or start a new conversation with one.
Create responseSave a response (reply template) for an organization.
Create taskCreate a task for a team or people, or a subtask inside a conversation.
Delete email draftDelete a draft from its conversation.
Delete postDelete a post from its conversation.
Delete responseDelete a saved response.
Get contactGet one contact with their emails, phone numbers and companies.
Get conversationGet one conversation: subject, people, labels, counts and its Missive address.
Get messageGet one message with its sender, recipients, full text and attachments.
Get taskGet one task with its assignees and team spelled out.
List contact booksList the contact books you can use, with who they are shared with.
List contactsList the contacts in one contact book, or search them by name, email, phone, company or notes.
List conversation commentsList the internal comments in a conversation, newest first.
List conversation messagesList the messages in a conversation, newest first.
List conversation postsList the posts in a conversation, newest first.
List conversationsList conversations in a mailbox, shared label or team, newest activity first.
List organizationsList the Missive organizations you belong to, with their ids.
List responsesList the saved responses (reply templates) you can use.
List shared labelsList the shared labels in your organizations, with their colors and who can use them.
List tasksList tasks you can see, most recently active first, filtered by organization, team, assignee, state, due date or conversation.
List teamsList the teams in your organizations, with their members.
List usersList the people in your organizations: name, email and id.
Send emailSend an email from one of your Missive addresses, now or at a later time.
Update contactChange a contact's name, notes or star, or add an email or phone number.
Update conversationClose, reopen, rename, recolor, assign or label a conversation without leaving a post.
Update responseChange a saved response's title, subject or text.
Update taskChange a task: rename it, set its state (Closed completes it), reassign it or move its due date.

Create contact

Add a contact to a contact book, with an email, phone number and company if you have them. Missive's API cannot delete contacts, so delete test contacts in Missive.

Inputs

Contact bookcontact_booktextRequired
The contact book to add the contact to.
First namefirst_nametext
The contact's first name.
Last namelast_nametext
The contact's last name.
Emailemailtext
The contact's email address.
Email typeemail_labeltext
What kind of address it is. Defaults to work.One of: work (Work (default)), home, personal, other.
Phonephonetext
The contact's phone number, with country code.
Phone typephone_labeltext
What kind of number it is. Defaults to mobile.One of: mobile (Mobile (default)), main, work, home, other.
Companycompanytext
The company the contact works for.
Job titlejob_titletext
Their role at the company. Needs a company.
Notesnotestext
Notes about the contact.
Starredstarredtrue/false
Mark the contact as a favorite.

Outputs

contactobject
The new contact
Example output
{
  "contact": {
    "contact_book": "551b8675-11e9-49c3-aac0-01fb8510d862",
    "deleted": false,
    "file_as": "",
    "first_name": "Pat",
    "id": "5960dcd2-3382-4430-aa70-955a2c62040a",
    "infos": [
      {
        "custom_label": "",
        "kind": "email",
        "label": "work",
        "name": "",
        "value": "pat@example.com"
      }
    ],
    "job_title": "",
    "last_name": "Lee",
    "memberships": [],
    "middle_name": "",
    "modified_at": 1790000000,
    "nickname": "",
    "notes": "",
    "starred": false
  }
}

Create email draft

Save an email draft in Missive for someone to review and send from the app. Nothing is sent.

Inputs

Fromfrom_addresstextRequired
The sender's email address. It must be one of your Missive email addresses or aliases.
From namefrom_nametext
The name shown as the sender.
TototextRequired
Who to send it to. Separate several addresses with commas.
Cccctext
Addresses to copy, separated by commas.
Bccbcctext
Addresses to copy without the others seeing, separated by commas.
Subjectsubjecttext
The subject line. When replying, start it with 'Re: ' and the original subject so the other person's mail keeps it in one thread.
MessagebodytextRequired
The message, as text or HTML.
Reply in conversationconversation_idtext
To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
Organizationorganizationtext
The organization to share a new conversation with. Leave empty to keep it private to you.
Add my signatureadd_default_signaturetrue/false
Add the signature of the address it is sent from.

Outputs

conversation_idtext
The conversation it is in
draftobject
The draft
draft_idtext
The draft's id
Example output
{
  "conversation_id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
  "draft": {
    "bcc_fields": [],
    "cc_fields": [],
    "conversation": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
    "created_at": 0,
    "from_field": {
      "address": "jo@example.com",
      "id": "",
      "name": "Jo Bloggs",
      "username": ""
    },
    "id": "7b2f6f6d-33c7-4b1a-8f0a-0a8a5f43a7c1",
    "preview": "Thanks for getting in touch",
    "subject": "Hello",
    "to_fields": [
      {
        "address": "pat@example.com",
        "id": "",
        "name": "",
        "username": ""
      }
    ],
    "type": "email",
    "updated_at": 0
  },
  "draft_id": "7b2f6f6d-33c7-4b1a-8f0a-0a8a5f43a7c1"
}

Create post

Add a post to a conversation, or start a new conversation with one. A post shows your team what happened, and can close the conversation as it does.

Inputs

TexttexttextRequired
What the post says, up to 8,000 characters.
Conversationconversation_idtext
The conversation to post in: its id or Missive address. Leave empty to start a new conversation.
Organizationorganizationtext
Share a new conversation with this organization. Leave empty to keep it private to you.
Subjectconversation_subjecttext
The subject for a new conversation.
Posted byusernametext
The name shown as the author. Defaults to you.
Notification titlenotification_titletext
The title of the notification. Defaults to the author.
Notification textnotification_bodytext
The text of the notification. Defaults to the post.
Close conversationclosetrue/false
Close the conversation for everyone with this post.

Outputs

conversation_idtext
The conversation it is in
postobject
The post
post_idtext
The post's id
Example output
{
  "conversation_id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
  "post": {
    "attachments": [],
    "conversation": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
    "created_at": 1790000300,
    "id": "ee31f156-db95-4158-923f-b26450e0dbf7",
    "markdown": "",
    "notification": {
      "body": "Order shipped",
      "title": "Lodol"
    },
    "text": "Order shipped",
    "username": "Lodol"
  },
  "post_id": "ee31f156-db95-4158-923f-b26450e0dbf7"
}

Create response

Save a response (reply template) for an organization.

Inputs

TitletitletextRequired
The name people see when picking the response.
OrganizationorganizationtextRequired
The organization to save it in.
Subjectsubjecttext
The subject line the response fills in.
Messagebodytext
The text of the response, as text or HTML.

Outputs

responseobject
The new response
Example output
{
  "response": {
    "attachments": [],
    "body": "<p>Welcome aboard!</p>",
    "id": "75ad834a-9bd6-4008-b9e6-fc9fa2e7770b",
    "modified_at": 1790000000,
    "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
    "share_with_team": "",
    "shared_labels": [],
    "subject": "Welcome!",
    "title": "Welcome",
    "to_fields": [],
    "user": ""
  }
}

Create task

Create a task for a team or people, or a subtask inside a conversation. Missive's API cannot delete tasks: set a test task's state to Closed with 'Update task'.

Inputs

TitletitletextRequired
What needs doing.
Descriptiondescriptiontext
More detail about the task.
Statestatetext
Where the task stands.One of: todo (To do), in_progress (In progress), closed.
Organizationorganizationtext
The organization the task is in. Needed when you pick a team or people.
Teamteamtext
The team responsible. Give a team or people.
Assigneesassigneeslist
The people responsible for the task.
Duedue_atdate and time
When the task is due.
Inside conversationconversation_idtext
To make it a subtask, the conversation's id or Missive address.

Outputs

taskobject
The new task
Example output
{
  "task": {
    "assignees": [
      "1ce8117e-ae42-4304-b953-c81656da4bd1"
    ],
    "closed_at": 0,
    "conversation": "",
    "description": "About the order",
    "due_at": 1790100000,
    "id": "a5d2aa1c-3828-4f90-bbd8-3dffaadda97e",
    "last_activity_at": 1790000400,
    "started_at": 0,
    "state": "todo",
    "team": null,
    "title": "Call Pat back",
    "type": "task"
  }
}

Delete email draft

Delete a draft from its conversation.

Inputs

Draft IDdraft_idtextRequired
The draft's id, from 'Create email draft'.

Outputs

deletedtrue/false
Always true once deleted
draft_idtext
The draft deleted
Example output
{
  "deleted": true,
  "draft_id": "7b2f6f6d-33c7-4b1a-8f0a-0a8a5f43a7c1"
}

Delete post

Delete a post from its conversation. In a shared conversation only an organization admin can.

Inputs

Post IDpost_idtextRequired
The post's id, from 'Create post' or 'List conversation posts'.

Outputs

deletedtrue/false
Always true once deleted
post_idtext
The post deleted
Example output
{
  "deleted": true,
  "post_id": "ee31f156-db95-4158-923f-b26450e0dbf7"
}

Delete response

Delete a saved response.

Inputs

Response IDresponse_idtextRequired
The response's id, from 'List responses' or 'Create response'.

Outputs

deletedtrue/false
Always true once deleted
response_idtext
The response deleted
Example output
{
  "deleted": true,
  "response_id": "75ad834a-9bd6-4008-b9e6-fc9fa2e7770b"
}

Get contact

Get one contact with their emails, phone numbers and companies.

Inputs

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

Outputs

contactobject
The contact
Example output
{
  "contact": {
    "contact_book": "551b8675-11e9-49c3-aac0-01fb8510d862",
    "deleted": false,
    "file_as": "",
    "first_name": "Pat",
    "id": "5960dcd2-3382-4430-aa70-955a2c62040a",
    "infos": [
      {
        "custom_label": "",
        "kind": "email",
        "label": "work",
        "name": "",
        "value": "pat@example.com"
      }
    ],
    "job_title": "",
    "last_name": "Lee",
    "memberships": [],
    "middle_name": "",
    "modified_at": 1790000000,
    "nickname": "",
    "notes": "",
    "starred": false
  }
}

Get conversation

Get one conversation: subject, people, labels, counts and its Missive address.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id or its Missive address, from 'List conversations' or an earlier step.

Outputs

conversationobject
The conversation
Example output
{
  "conversation": {
    "app_url": "",
    "assignee_emails": "",
    "assignee_names": "",
    "assignees": [],
    "attachments_count": 0,
    "authors": [],
    "closed_at": 0,
    "color": "",
    "completed_tasks_count": 0,
    "created_at": 1790000000,
    "drafts_count": 0,
    "external_authors": [],
    "id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
    "last_activity_at": 1790000100,
    "latest_message_subject": "Question?",
    "messages_count": 1,
    "organization": {
      "id": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "name": "Acme"
    },
    "shared_label_names": "",
    "shared_labels": [],
    "subject": "Question?",
    "tasks_count": 0,
    "team": {},
    "users": [],
    "web_url": "https://mail.missiveapp.com/#inbox/conversations/6d3c9b1c-7067-4a28-8ea6-ea91340b67cc"
  }
}

Get message

Get one message with its sender, recipients, full text and attachments.

Inputs

Message IDmessage_idtextRequired
The message's id, from 'List conversation messages'.

Outputs

messageobject
The message
Example output
{
  "message": {
    "attachments": [],
    "author": {},
    "bcc_fields": [],
    "body": "<p>Hi, a question about my order</p>",
    "cc_fields": [],
    "created_at": 0,
    "delivered_at": 1790000000,
    "email_message_id": "",
    "external_id": "",
    "from_field": {
      "address": "pat@example.com",
      "id": "",
      "name": "Pat Lee",
      "username": ""
    },
    "id": "3fa4bcf5-e57e-47a4-9422-de2cce5f802e",
    "preview": "Hi, a question about my order",
    "subject": "Question?",
    "to_fields": [
      {
        "address": "hello@acme.example",
        "id": "",
        "name": "Acme",
        "username": ""
      }
    ],
    "type": "email",
    "updated_at": 0
  }
}

Get task

Get one task with its assignees and team spelled out.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or 'Create task'.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assignees": [
      "1ce8117e-ae42-4304-b953-c81656da4bd1"
    ],
    "closed_at": 0,
    "conversation": "",
    "description": "About the order",
    "due_at": 1790100000,
    "id": "a5d2aa1c-3828-4f90-bbd8-3dffaadda97e",
    "last_activity_at": 1790000400,
    "started_at": 0,
    "state": "todo",
    "team": null,
    "title": "Call Pat back",
    "type": "task"
  }
}

List contact books

List the contact books you can use, with who they are shared with.

Inputs

Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

contact_bookslist
The contact books
countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
Example output
{
  "contact_books": [
    {
      "description": "",
      "id": "551b8675-11e9-49c3-aac0-01fb8510d862",
      "name": "Customers",
      "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "share_with_organization": true,
      "share_with_team": "",
      "share_with_users": [],
      "user": "1ce8117e-ae42-4304-b953-c81656da4bd1"
    }
  ],
  "count": 1,
  "next_offset": ""
}

List contacts

List the contacts in one contact book, or search them by name, email, phone, company or notes.

Inputs

Contact bookcontact_booktextRequired
The contact book to read.
Searchsearchtext
Only contacts matching this text.
Orderordertext
How to sort them. Defaults to last name.One of: last_name (Last name (default)), last_modified (Most recently changed).
Changed sincemodified_sincedate and time
Only contacts created or changed after this time.
Include deletedinclude_deletedtrue/false
Also list contacts deleted since the time above, with just their id.
Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

contactslist
The contacts
countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
Example output
{
  "contacts": [
    {
      "contact_book": "551b8675-11e9-49c3-aac0-01fb8510d862",
      "deleted": false,
      "file_as": "",
      "first_name": "Pat",
      "id": "5960dcd2-3382-4430-aa70-955a2c62040a",
      "infos": [
        {
          "custom_label": "",
          "kind": "email",
          "label": "work",
          "name": "",
          "value": "pat@example.com"
        }
      ],
      "job_title": "",
      "last_name": "Lee",
      "memberships": [],
      "middle_name": "",
      "modified_at": 1790000000,
      "nickname": "",
      "notes": "",
      "starred": false
    }
  ],
  "count": 1,
  "next_offset": ""
}

List conversation comments

List the internal comments in a conversation, newest first.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id or its Missive address, from 'List conversations' or an earlier step.
Page sizelimitnumber
How many to return, up to 10. Defaults to 10.From 1 to 10.
Older thanuntildate and time
Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

Outputs

commentslist
The comments
countnumber
How many came back
next_untiltext
Pass as Older than to get the next page; empty on the last page
Example output
{
  "comments": [
    {
      "attachment": {
        "extension": "",
        "filename": "",
        "id": "",
        "media_type": "",
        "size": 0,
        "sub_type": "",
        "url": ""
      },
      "author": {
        "avatar_url": "https://example.com/jo.png",
        "email": "jo@example.com",
        "id": "1ce8117e-ae42-4304-b953-c81656da4bd1",
        "me": true,
        "name": "Jo Bloggs"
      },
      "body": "Looking into it",
      "created_at": 1790000200,
      "id": "81eed561-4908-4738-9a9f-2da886b1de43",
      "mentions": [],
      "task": {}
    }
  ],
  "count": 1,
  "next_until": ""
}

List conversation messages

List the messages in a conversation, newest first. The text of each is in 'Get message'.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id or its Missive address, from 'List conversations' or an earlier step.
Page sizelimitnumber
How many to return, up to 10. Defaults to 10.From 1 to 10.
Older thanuntildate and time
Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

Outputs

countnumber
How many came back
messageslist
The messages
next_untiltext
Pass as Older than to get the next page; empty on the last page
Example output
{
  "count": 1,
  "messages": [
    {
      "attachments": [],
      "author": {},
      "bcc_fields": [],
      "body": "<p>Hi, a question about my order</p>",
      "cc_fields": [],
      "created_at": 0,
      "delivered_at": 1790000000,
      "email_message_id": "",
      "external_id": "",
      "from_field": {
        "address": "pat@example.com",
        "id": "",
        "name": "Pat Lee",
        "username": ""
      },
      "id": "3fa4bcf5-e57e-47a4-9422-de2cce5f802e",
      "preview": "Hi, a question about my order",
      "subject": "Question?",
      "to_fields": [
        {
          "address": "hello@acme.example",
          "id": "",
          "name": "Acme",
          "username": ""
        }
      ],
      "type": "email",
      "updated_at": 0
    }
  ],
  "next_until": ""
}

List conversation posts

List the posts in a conversation, newest first.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id or its Missive address, from 'List conversations' or an earlier step.
Page sizelimitnumber
How many to return, up to 10. Defaults to 10.From 1 to 10.
Older thanuntildate and time
Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

Outputs

countnumber
How many came back
next_untiltext
Pass as Older than to get the next page; empty on the last page
postslist
The posts
Example output
{
  "count": 1,
  "next_until": "",
  "posts": [
    {
      "attachments": [],
      "conversation": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
      "created_at": 1790000300,
      "id": "ee31f156-db95-4158-923f-b26450e0dbf7",
      "markdown": "",
      "notification": {
        "body": "Order shipped",
        "title": "Lodol"
      },
      "text": "Order shipped",
      "username": "Lodol"
    }
  ]
}

List conversations

List conversations in a mailbox, shared label or team, newest activity first. Pick the mailbox first; labels and teams show only when they apply.

Inputs

Wheremailboxtext
Which mailbox to read. Defaults to the inbox.One of: inbox (Inbox (default)), all (All mail), assigned (Assigned to me), closed, snoozed, flagged (Starred), trashed (Trash), junked (Spam), drafts, shared_label (A shared label), and 3 more.
Shared labelshared_label_idtext
The label whose conversations to list.Only when Where is A shared label.
Teamteamtext
The team whose conversations to list.Only when Where is A team's inbox, A team's closed conversations or All of a team's conversations.
Organizationorganizationtext
Only conversations shared with this organization.
With email addressemailtext
Only conversations involving this address.
With email domaindomaintext
Only conversations involving this domain, like example.com. Not together with an address.
Page sizelimitnumber
How many to return, up to 50. Defaults to 25.From 1 to 50.
Older thanuntildate and time
Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

Outputs

conversationslist
The conversations
countnumber
How many came back
next_untiltext
Pass as Older than to get the next page; empty on the last page
Example output
{
  "conversations": [
    {
      "app_url": "",
      "assignee_emails": "",
      "assignee_names": "",
      "assignees": [],
      "attachments_count": 0,
      "authors": [],
      "closed_at": 0,
      "color": "",
      "completed_tasks_count": 0,
      "created_at": 1790000000,
      "drafts_count": 0,
      "external_authors": [],
      "id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
      "last_activity_at": 1790000100,
      "latest_message_subject": "Question?",
      "messages_count": 1,
      "organization": {
        "id": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
        "name": "Acme"
      },
      "shared_label_names": "",
      "shared_labels": [],
      "subject": "Question?",
      "tasks_count": 0,
      "team": {},
      "users": [],
      "web_url": "https://mail.missiveapp.com/#inbox/conversations/6d3c9b1c-7067-4a28-8ea6-ea91340b67cc"
    }
  ],
  "count": 1,
  "next_until": ""
}

List organizations

List the Missive organizations you belong to, with their ids.

Inputs

Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
organizationslist
The organizations
Example output
{
  "count": 1,
  "next_offset": "",
  "organizations": [
    {
      "id": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "name": "Acme"
    }
  ]
}

List responses

List the saved responses (reply templates) you can use.

Inputs

Organizationorganizationtext
Only this organization's. Leave empty for all.
Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
responseslist
The responses
Example output
{
  "count": 1,
  "next_offset": "",
  "responses": [
    {
      "attachments": [],
      "body": "<p>Welcome aboard!</p>",
      "id": "75ad834a-9bd6-4008-b9e6-fc9fa2e7770b",
      "modified_at": 1790000000,
      "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "share_with_team": "",
      "shared_labels": [],
      "subject": "Welcome!",
      "title": "Welcome",
      "to_fields": [],
      "user": ""
    }
  ]
}

List shared labels

List the shared labels in your organizations, with their colors and who can use them.

Inputs

Organizationorganizationtext
Only this organization's. Leave empty for all.
Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
shared_labelslist
The shared labels
Example output
{
  "count": 1,
  "next_offset": "",
  "shared_labels": [
    {
      "color": "#430098",
      "id": "9825718b-3407-40b8-800d-a27361c86102",
      "name": "Follow up",
      "name_with_parent_names": "Follow up",
      "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "parent": "",
      "share_with_organization": true,
      "share_with_team": "",
      "share_with_users": [],
      "visibility": "organization"
    }
  ]
}

List tasks

List tasks you can see, most recently active first, filtered by organization, team, assignee, state, due date or conversation.

Inputs

Organizationorganizationtext
Only this organization's. Leave empty for all.
Teamteamtext
Only this team's tasks.
Assigned toassigneetext
Only this person's tasks.
Statestatetext
Only tasks in this state.One of: todo (To do), in_progress (In progress), closed.
Kindtask_typetext
Tasks, conversations with a due date, or both.One of: all (Tasks and conversations with a due date (default)), task (Tasks only), conversation (Conversations only).
In conversationconversation_idtext
Only subtasks of this conversation.
Due on or afterdue_afterdate and time
Only tasks due at or after this time.
Due on or beforedue_beforedate and time
Only tasks due at or before this time.
Page sizelimitnumber
How many to return, 2 to 50. Defaults to 25.From 2 to 50.
Older thanuntildate and time
Only tasks active before this time, to get the next page. Use 'Next page time' from the last page.

Outputs

countnumber
How many came back
next_untiltext
Pass as Older than to get the next page; empty on the last page
taskslist
The tasks
Example output
{
  "count": 1,
  "next_until": "",
  "tasks": [
    {
      "assignees": [
        "1ce8117e-ae42-4304-b953-c81656da4bd1"
      ],
      "closed_at": 0,
      "conversation": "",
      "description": "About the order",
      "due_at": 1790100000,
      "id": "a5d2aa1c-3828-4f90-bbd8-3dffaadda97e",
      "last_activity_at": 1790000400,
      "started_at": 0,
      "state": "todo",
      "team": null,
      "title": "Call Pat back",
      "type": "task"
    }
  ]
}

List teams

List the teams in your organizations, with their members.

Inputs

Organizationorganizationtext
Only this organization's. Leave empty for all.
Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

countnumber
How many came back
next_offsettext
Pass as Offset to get the next page; empty on the last page
teamslist
The teams
Example output
{
  "count": 1,
  "next_offset": "",
  "teams": [
    {
      "active_members": [
        "1ce8117e-ae42-4304-b953-c81656da4bd1"
      ],
      "chat_room_enabled": true,
      "color": "",
      "emoji": "",
      "id": "0e24f298-965d-4475-9220-b32636a1e2c3",
      "name": "Support",
      "observers": [],
      "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "team_inbox_enabled": true
    }
  ]
}

List users

List the people in your organizations: name, email and id. 'me' is the connected user.

Inputs

Organizationorganizationtext
Only this organization's. Leave empty for all.
Page sizelimitnumber
How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
Offsetoffsetnumber
How many to skip, to get a later page. Use 'Next offset'.At least 0.

Outputs

countnumber
How many came back
meobject
The connected user, if on this page
next_offsettext
Pass as Offset to get the next page; empty on the last page
userslist
The users
Example output
{
  "count": 1,
  "me": {
    "avatar_url": "https://example.com/jo.png",
    "email": "jo@example.com",
    "id": "1ce8117e-ae42-4304-b953-c81656da4bd1",
    "me": true,
    "name": "Jo Bloggs"
  },
  "next_offset": "",
  "users": [
    {
      "avatar_url": "https://example.com/jo.png",
      "email": "jo@example.com",
      "id": "1ce8117e-ae42-4304-b953-c81656da4bd1",
      "me": true,
      "name": "Jo Bloggs"
    }
  ]
}

Send email

Send an email from one of your Missive addresses, now or at a later time. It lands in a Missive conversation, new or the one you reply in.

Inputs

Fromfrom_addresstextRequired
The sender's email address. It must be one of your Missive email addresses or aliases.
From namefrom_nametext
The name shown as the sender.
TototextRequired
Who to send it to. Separate several addresses with commas.
Cccctext
Addresses to copy, separated by commas.
Bccbcctext
Addresses to copy without the others seeing, separated by commas.
Subjectsubjecttext
The subject line. When replying, start it with 'Re: ' and the original subject so the other person's mail keeps it in one thread.
MessagebodytextRequired
The message, as text or HTML.
Reply in conversationconversation_idtext
To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
Organizationorganizationtext
The organization to share a new conversation with. Leave empty to keep it private to you.
Add my signatureadd_default_signaturetrue/false
Add the signature of the address it is sent from.
Send atsend_atdate and time
Send later, at this time. Leave empty to send right away.

Outputs

conversation_idtext
The conversation it is in
draftobject
The message, as Missive recorded it
draft_idtext
The message's id
Example output
{
  "conversation_id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
  "draft": {
    "bcc_fields": [],
    "cc_fields": [],
    "conversation": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
    "created_at": 0,
    "from_field": {
      "address": "jo@example.com",
      "id": "",
      "name": "Jo Bloggs",
      "username": ""
    },
    "id": "7b2f6f6d-33c7-4b1a-8f0a-0a8a5f43a7c1",
    "preview": "Thanks for getting in touch",
    "subject": "Hello",
    "to_fields": [
      {
        "address": "pat@example.com",
        "id": "",
        "name": "",
        "username": ""
      }
    ],
    "type": "email",
    "updated_at": 0
  },
  "draft_id": "7b2f6f6d-33c7-4b1a-8f0a-0a8a5f43a7c1"
}

Update contact

Change a contact's name, notes or star, or add an email or phone number. Existing emails and numbers are kept. Empty fields are left as they are.

Inputs

Contact IDcontact_idtextRequired
The contact's id, from 'List contacts' or 'Create contact'.
First namefirst_nametext
The contact's first name.
Last namelast_nametext
The contact's last name.
Add emailadd_emailtext
An email address to add to the contact.
Email typeemail_labeltext
What kind of address it is. Defaults to work.One of: work (Work (default)), home, personal, other.
Add phoneadd_phonetext
A phone number to add, with country code.
Phone typephone_labeltext
What kind of number it is. Defaults to mobile.One of: mobile (Mobile (default)), main, work, home, other.
Notesnotestext
Notes about the contact.
Starredstarredtrue/false
Mark the contact as a favorite.

Outputs

contactobject
The contact, as changed
Example output
{
  "contact": {
    "contact_book": "551b8675-11e9-49c3-aac0-01fb8510d862",
    "deleted": false,
    "file_as": "",
    "first_name": "Pat",
    "id": "5960dcd2-3382-4430-aa70-955a2c62040a",
    "infos": [
      {
        "custom_label": "",
        "kind": "email",
        "label": "work",
        "name": "",
        "value": "pat@example.com"
      }
    ],
    "job_title": "",
    "last_name": "Lee",
    "memberships": [],
    "middle_name": "",
    "modified_at": 1790000000,
    "nickname": "",
    "notes": "Prefers email",
    "starred": false
  }
}

Update conversation

Close, reopen, rename, recolor, assign or label a conversation without leaving a post. Empty fields are left as they are.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id or its Missive address, from 'List conversations' or an earlier step.
Statestatetext
Close or reopen it for everyone, or move it to the inbox.One of: close, reopen, add_to_inbox (Move to the inbox).
Subjectsubjecttext
A new subject.
Colorcolortext
A new color for the conversation.One of: good (Green), warning (Yellow), danger (Red).
Organizationorganizationtext
Needed to assign people or add shared labels: the organization they belong to.
Teamteamtext
Link the conversation to this team.
Assign toadd_assigneeslist
People to assign it to.
Unassignremove_assigneeslist
People to take off it.
Add shared labelsadd_shared_labelslist
Labels to put on it.
Remove shared labelsremove_shared_labelslist
Labels to take off it.

Outputs

conversationobject
The conversation, as changed
Example output
{
  "conversation": {
    "app_url": "",
    "assignee_emails": "",
    "assignee_names": "",
    "assignees": [],
    "attachments_count": 0,
    "authors": [],
    "closed_at": 1790000500,
    "color": "",
    "completed_tasks_count": 0,
    "created_at": 1790000000,
    "drafts_count": 0,
    "external_authors": [],
    "id": "6d3c9b1c-7067-4a28-8ea6-ea91340b67cc",
    "last_activity_at": 1790000100,
    "latest_message_subject": "Question?",
    "messages_count": 1,
    "organization": {
      "id": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
      "name": "Acme"
    },
    "shared_label_names": "",
    "shared_labels": [],
    "subject": "Question?",
    "tasks_count": 0,
    "team": {},
    "users": [],
    "web_url": "https://mail.missiveapp.com/#inbox/conversations/6d3c9b1c-7067-4a28-8ea6-ea91340b67cc"
  }
}

Update response

Change a saved response's title, subject or text. Empty fields are left as they are.

Inputs

Response IDresponse_idtextRequired
The response's id, from 'List responses' or 'Create response'.
Titletitletext
A new title.
Subjectsubjecttext
The subject line the response fills in.
Messagebodytext
The text of the response, as text or HTML.

Outputs

responseobject
The response, as changed
Example output
{
  "response": {
    "attachments": [],
    "body": "<p>Welcome aboard!</p>",
    "id": "75ad834a-9bd6-4008-b9e6-fc9fa2e7770b",
    "modified_at": 1790000000,
    "organization": "0d9bab85-a74f-4ece-9142-0f9b9f36ff92",
    "share_with_team": "",
    "shared_labels": [],
    "subject": "Welcome!",
    "title": "Welcome (updated)",
    "to_fields": [],
    "user": ""
  }
}

Update task

Change a task: rename it, set its state (Closed completes it), reassign it or move its due date. Empty fields are left as they are.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or 'Create task'.
Titletitletext
A new title.
Descriptiondescriptiontext
More detail about the task.
Statestatetext
Where the task stands.One of: todo (To do), in_progress (In progress), closed.
Teamteamtext
Move the task to this team.
Assigneesassigneeslist
The people responsible for the task.
Duedue_atdate and time
When the task is due.

Outputs

taskobject
The task, as changed
Example output
{
  "task": {
    "assignees": [
      "1ce8117e-ae42-4304-b953-c81656da4bd1"
    ],
    "closed_at": 0,
    "conversation": "",
    "description": "About the order",
    "due_at": 1790100000,
    "id": "a5d2aa1c-3828-4f90-bbd8-3dffaadda97e",
    "last_activity_at": 1790000400,
    "started_at": 0,
    "state": "closed",
    "team": null,
    "title": "Call Pat back",
    "type": "task"
  }
}

On this page