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
| Action | What it does |
|---|---|
| Create contact | Add a contact to a contact book, with an email, phone number and company if you have them. |
| Create email draft | Save an email draft in Missive for someone to review and send from the app. |
| Create post | Add a post to a conversation, or start a new conversation with one. |
| Create response | Save a response (reply template) for an organization. |
| Create task | Create a task for a team or people, or a subtask inside a conversation. |
| Delete email draft | Delete a draft from its conversation. |
| Delete post | Delete a post from its conversation. |
| Delete response | Delete a saved response. |
| Get contact | Get one contact with their emails, phone numbers and companies. |
| Get conversation | Get one conversation: subject, people, labels, counts and its Missive address. |
| Get message | Get one message with its sender, recipients, full text and attachments. |
| Get task | Get one task with its assignees and team spelled out. |
| List contact books | List the contact books you can use, with who they are shared with. |
| List contacts | List the contacts in one contact book, or search them by name, email, phone, company or notes. |
| List conversation comments | List the internal comments in a conversation, newest first. |
| List conversation messages | List the messages in a conversation, newest first. |
| List conversation posts | List the posts in a conversation, newest first. |
| List conversations | List conversations in a mailbox, shared label or team, newest activity first. |
| List organizations | List the Missive organizations you belong to, with their ids. |
| List responses | List the saved responses (reply templates) you can use. |
| List shared labels | List the shared labels in your organizations, with their colors and who can use them. |
| List tasks | List tasks you can see, most recently active first, filtered by organization, team, assignee, state, due date or conversation. |
| List teams | List the teams in your organizations, with their members. |
| List users | List the people in your organizations: name, email and id. |
| Send email | Send an email from one of your Missive addresses, now or at a later time. |
| Update contact | Change a contact's name, notes or star, or add an email or phone number. |
| Update conversation | Close, reopen, rename, recolor, assign or label a conversation without leaving a post. |
| Update response | Change a saved response's title, subject or text. |
| Update task | Change 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 book
contact_booktextRequired - The contact book to add the contact to.
- First name
first_nametext - The contact's first name.
- Last name
last_nametext - The contact's last name.
- Email
emailtext - The contact's email address.
- Email type
email_labeltext - What kind of address it is. Defaults to work.One of:
work(Work (default)),home,personal,other. - Phone
phonetext - The contact's phone number, with country code.
- Phone type
phone_labeltext - What kind of number it is. Defaults to mobile.One of:
mobile(Mobile (default)),main,work,home,other. - Company
companytext - The company the contact works for.
- Job title
job_titletext - Their role at the company. Needs a company.
- Notes
notestext - Notes about the contact.
- Starred
starredtrue/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
- From
from_addresstextRequired - The sender's email address. It must be one of your Missive email addresses or aliases.
- From name
from_nametext - The name shown as the sender.
- To
totextRequired - Who to send it to. Separate several addresses with commas.
- Cc
cctext - Addresses to copy, separated by commas.
- Bcc
bcctext - Addresses to copy without the others seeing, separated by commas.
- Subject
subjecttext - The subject line. When replying, start it with 'Re: ' and the original subject so the other person's mail keeps it in one thread.
- Message
bodytextRequired - The message, as text or HTML.
- Reply in conversation
conversation_idtext - To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
- Organization
organizationtext - The organization to share a new conversation with. Leave empty to keep it private to you.
- Add my signature
add_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
- Text
texttextRequired - What the post says, up to 8,000 characters.
- Conversation
conversation_idtext - The conversation to post in: its id or Missive address. Leave empty to start a new conversation.
- Organization
organizationtext - Share a new conversation with this organization. Leave empty to keep it private to you.
- Subject
conversation_subjecttext - The subject for a new conversation.
- Posted by
usernametext - The name shown as the author. Defaults to you.
- Notification title
notification_titletext - The title of the notification. Defaults to the author.
- Notification text
notification_bodytext - The text of the notification. Defaults to the post.
- Close conversation
closetrue/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
- Title
titletextRequired - The name people see when picking the response.
- Organization
organizationtextRequired - The organization to save it in.
- Subject
subjecttext - The subject line the response fills in.
- Message
bodytext - 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
- Title
titletextRequired - What needs doing.
- Description
descriptiontext - More detail about the task.
- State
statetext - Where the task stands.One of:
todo(To do),in_progress(In progress),closed. - Organization
organizationtext - The organization the task is in. Needed when you pick a team or people.
- Team
teamtext - The team responsible. Give a team or people.
- Assignees
assigneeslist - The people responsible for the task.
- Due
due_atdate and time - When the task is due.
- Inside conversation
conversation_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 ID
draft_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 ID
post_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 ID
response_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 ID
contact_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 ID
conversation_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 ID
message_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 ID
task_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 size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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 book
contact_booktextRequired - The contact book to read.
- Search
searchtext - Only contacts matching this text.
- Order
ordertext - How to sort them. Defaults to last name.One of:
last_name(Last name (default)),last_modified(Most recently changed). - Changed since
modified_sincedate and time - Only contacts created or changed after this time.
- Include deleted
include_deletedtrue/false - Also list contacts deleted since the time above, with just their id.
- Page size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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 ID
conversation_idtextRequired - The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size
limitnumber - How many to return, up to 10. Defaults to 10.From 1 to 10.
- Older than
untildate 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 ID
conversation_idtextRequired - The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size
limitnumber - How many to return, up to 10. Defaults to 10.From 1 to 10.
- Older than
untildate 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 ID
conversation_idtextRequired - The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size
limitnumber - How many to return, up to 10. Defaults to 10.From 1 to 10.
- Older than
untildate 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
- Where
mailboxtext - 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 label
shared_label_idtext - The label whose conversations to list.Only when Where is A shared label.
- Team
teamtext - 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.
- Organization
organizationtext - Only conversations shared with this organization.
- With email address
emailtext - Only conversations involving this address.
- With email domain
domaintext - Only conversations involving this domain, like example.com. Not together with an address.
- Page size
limitnumber - How many to return, up to 50. Defaults to 25.From 1 to 50.
- Older than
untildate 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 size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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
- Organization
organizationtext - Only this organization's. Leave empty for all.
- Page size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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
- Organization
organizationtext - Only this organization's. Leave empty for all.
- Page size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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
- Organization
organizationtext - Only this organization's. Leave empty for all.
- Team
teamtext - Only this team's tasks.
- Assigned to
assigneetext - Only this person's tasks.
- State
statetext - Only tasks in this state.One of:
todo(To do),in_progress(In progress),closed. - Kind
task_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 conversation
conversation_idtext - Only subtasks of this conversation.
- Due on or after
due_afterdate and time - Only tasks due at or after this time.
- Due on or before
due_beforedate and time - Only tasks due at or before this time.
- Page size
limitnumber - How many to return, 2 to 50. Defaults to 25.From 2 to 50.
- Older than
untildate 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
- Organization
organizationtext - Only this organization's. Leave empty for all.
- Page size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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
- Organization
organizationtext - Only this organization's. Leave empty for all.
- Page size
limitnumber - How many to return, 1 to 200. Missive's default is 50.From 1 to 200.
- Offset
offsetnumber - 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
- From
from_addresstextRequired - The sender's email address. It must be one of your Missive email addresses or aliases.
- From name
from_nametext - The name shown as the sender.
- To
totextRequired - Who to send it to. Separate several addresses with commas.
- Cc
cctext - Addresses to copy, separated by commas.
- Bcc
bcctext - Addresses to copy without the others seeing, separated by commas.
- Subject
subjecttext - The subject line. When replying, start it with 'Re: ' and the original subject so the other person's mail keeps it in one thread.
- Message
bodytextRequired - The message, as text or HTML.
- Reply in conversation
conversation_idtext - To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
- Organization
organizationtext - The organization to share a new conversation with. Leave empty to keep it private to you.
- Add my signature
add_default_signaturetrue/false - Add the signature of the address it is sent from.
- Send at
send_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 ID
contact_idtextRequired - The contact's id, from 'List contacts' or 'Create contact'.
- First name
first_nametext - The contact's first name.
- Last name
last_nametext - The contact's last name.
- Add email
add_emailtext - An email address to add to the contact.
- Email type
email_labeltext - What kind of address it is. Defaults to work.One of:
work(Work (default)),home,personal,other. - Add phone
add_phonetext - A phone number to add, with country code.
- Phone type
phone_labeltext - What kind of number it is. Defaults to mobile.One of:
mobile(Mobile (default)),main,work,home,other. - Notes
notestext - Notes about the contact.
- Starred
starredtrue/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 ID
conversation_idtextRequired - The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- State
statetext - Close or reopen it for everyone, or move it to the inbox.One of:
close,reopen,add_to_inbox(Move to the inbox). - Subject
subjecttext - A new subject.
- Color
colortext - A new color for the conversation.One of:
good(Green),warning(Yellow),danger(Red). - Organization
organizationtext - Needed to assign people or add shared labels: the organization they belong to.
- Team
teamtext - Link the conversation to this team.
- Assign to
add_assigneeslist - People to assign it to.
- Unassign
remove_assigneeslist - People to take off it.
- Add shared labels
add_shared_labelslist - Labels to put on it.
- Remove shared labels
remove_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 ID
response_idtextRequired - The response's id, from 'List responses' or 'Create response'.
- Title
titletext - A new title.
- Subject
subjecttext - The subject line the response fills in.
- Message
bodytext - 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 ID
task_idtextRequired - The task's id, from 'List tasks' or 'Create task'.
- Title
titletext - A new title.
- Description
descriptiontext - More detail about the task.
- State
statetext - Where the task stands.One of:
todo(To do),in_progress(In progress),closed. - Team
teamtext - Move the task to this team.
- Assignees
assigneeslist - The people responsible for the task.
- Due
due_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"
}
}