# Missive

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

App · 29 actions. Web page: https://docs.lodol.com/docs/integrations/missive

## Actions

### 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_book`, text, required): The contact book to add the contact to.
- First name (`first_name`, text): The contact's first name.
- Last name (`last_name`, text): The contact's last name.
- Email (`email`, text): The contact's email address.
- Email type (`email_label`, text): What kind of address it is. Defaults to work. One of: `work` (Work (default)), `home`, `personal`, `other`.
- Phone (`phone`, text): The contact's phone number, with country code.
- Phone type (`phone_label`, text): What kind of number it is. Defaults to mobile. One of: `mobile` (Mobile (default)), `main`, `work`, `home`, `other`.
- Company (`company`, text): The company the contact works for.
- Job title (`job_title`, text): Their role at the company. Needs a company.
- Notes (`notes`, text): Notes about the contact.
- Starred (`starred`, true/false): Mark the contact as a favorite.

**Outputs**

- `contact` (object): The new contact

**Example output**

```json
{
  "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_address`, text, required): The sender's email address. It must be one of your Missive email addresses or aliases.
- From name (`from_name`, text): The name shown as the sender.
- To (`to`, text, required): Who to send it to. Separate several addresses with commas.
- Cc (`cc`, text): Addresses to copy, separated by commas.
- Bcc (`bcc`, text): Addresses to copy without the others seeing, separated by commas.
- Subject (`subject`, text): 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 (`body`, text, required): The message, as text or HTML.
- Reply in conversation (`conversation_id`, text): To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
- Organization (`organization`, text): The organization to share a new conversation with. Leave empty to keep it private to you.
- Add my signature (`add_default_signature`, true/false): Add the signature of the address it is sent from.

**Outputs**

- `conversation_id` (text): The conversation it is in
- `draft` (object): The draft
- `draft_id` (text): The draft's id

**Example output**

```json
{
  "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 (`text`, text, required): What the post says, up to 8,000 characters.
- Conversation (`conversation_id`, text): The conversation to post in: its id or Missive address. Leave empty to start a new conversation.
- Organization (`organization`, text): Share a new conversation with this organization. Leave empty to keep it private to you.
- Subject (`conversation_subject`, text): The subject for a new conversation.
- Posted by (`username`, text): The name shown as the author. Defaults to you.
- Notification title (`notification_title`, text): The title of the notification. Defaults to the author.
- Notification text (`notification_body`, text): The text of the notification. Defaults to the post.
- Close conversation (`close`, true/false): Close the conversation for everyone with this post.

**Outputs**

- `conversation_id` (text): The conversation it is in
- `post` (object): The post
- `post_id` (text): The post's id

**Example output**

```json
{
  "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 (`title`, text, required): The name people see when picking the response.
- Organization (`organization`, text, required): The organization to save it in.
- Subject (`subject`, text): The subject line the response fills in.
- Message (`body`, text): The text of the response, as text or HTML.

**Outputs**

- `response` (object): The new response

**Example output**

```json
{
  "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 (`title`, text, required): What needs doing.
- Description (`description`, text): More detail about the task.
- State (`state`, text): Where the task stands. One of: `todo` (To do), `in_progress` (In progress), `closed`.
- Organization (`organization`, text): The organization the task is in. Needed when you pick a team or people.
- Team (`team`, text): The team responsible. Give a team or people.
- Assignees (`assignees`, list): The people responsible for the task.
- Due (`due_at`, date and time): When the task is due.
- Inside conversation (`conversation_id`, text): To make it a subtask, the conversation's id or Missive address.

**Outputs**

- `task` (object): The new task

**Example output**

```json
{
  "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_id`, text, required): The draft's id, from 'Create email draft'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `draft_id` (text): The draft deleted

**Example output**

```json
{
  "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_id`, text, required): The post's id, from 'Create post' or 'List conversation posts'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `post_id` (text): The post deleted

**Example output**

```json
{
  "deleted": true,
  "post_id": "ee31f156-db95-4158-923f-b26450e0dbf7"
}
```

### Delete response

Delete a saved response.

**Inputs**

- Response ID (`response_id`, text, required): The response's id, from 'List responses' or 'Create response'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `response_id` (text): The response deleted

**Example output**

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

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The conversation's id or its Missive address, from 'List conversations' or an earlier step.

**Outputs**

- `conversation` (object): The conversation

**Example output**

```json
{
  "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_id`, text, required): The message's id, from 'List conversation messages'.

**Outputs**

- `message` (object): The message

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks' or 'Create task'.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `contact_books` (list): The contact books
- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page

**Example output**

```json
{
  "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_book`, text, required): The contact book to read.
- Search (`search`, text): Only contacts matching this text.
- Order (`order`, text): How to sort them. Defaults to last name. One of: `last_name` (Last name (default)), `last_modified` (Most recently changed).
- Changed since (`modified_since`, date and time): Only contacts created or changed after this time.
- Include deleted (`include_deleted`, true/false): Also list contacts deleted since the time above, with just their id.
- Page size (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page

**Example output**

```json
{
  "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_id`, text, required): The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size (`limit`, number): How many to return, up to 10. Defaults to 10. From 1 to 10.
- Older than (`until`, date and time): Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

**Outputs**

- `comments` (list): The comments
- `count` (number): How many came back
- `next_until` (text): Pass as Older than to get the next page; empty on the last page

**Example output**

```json
{
  "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_id`, text, required): The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size (`limit`, number): How many to return, up to 10. Defaults to 10. From 1 to 10.
- Older than (`until`, date and time): Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

**Outputs**

- `count` (number): How many came back
- `messages` (list): The messages
- `next_until` (text): Pass as Older than to get the next page; empty on the last page

**Example output**

```json
{
  "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_id`, text, required): The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- Page size (`limit`, number): How many to return, up to 10. Defaults to 10. From 1 to 10.
- Older than (`until`, date and time): Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

**Outputs**

- `count` (number): How many came back
- `next_until` (text): Pass as Older than to get the next page; empty on the last page
- `posts` (list): The posts

**Example output**

```json
{
  "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 (`mailbox`, text): 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_id`, text): The label whose conversations to list. Only when Where is A shared label.
- Team (`team`, text): 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 (`organization`, text): Only conversations shared with this organization.
- With email address (`email`, text): Only conversations involving this address.
- With email domain (`domain`, text): Only conversations involving this domain, like example.com. Not together with an address.
- Page size (`limit`, number): How many to return, up to 50. Defaults to 25. From 1 to 50.
- Older than (`until`, date and time): Only return older ones than this time, to get the next page. Use 'Next page time' from the last page.

**Outputs**

- `conversations` (list): The conversations
- `count` (number): How many came back
- `next_until` (text): Pass as Older than to get the next page; empty on the last page

**Example output**

```json
{
  "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 (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page
- `organizations` (list): The organizations

**Example output**

```json
{
  "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 (`organization`, text): Only this organization's. Leave empty for all.
- Page size (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page
- `responses` (list): The responses

**Example output**

```json
{
  "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 (`organization`, text): Only this organization's. Leave empty for all.
- Page size (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page
- `shared_labels` (list): The shared labels

**Example output**

```json
{
  "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 (`organization`, text): Only this organization's. Leave empty for all.
- Team (`team`, text): Only this team's tasks.
- Assigned to (`assignee`, text): Only this person's tasks.
- State (`state`, text): Only tasks in this state. One of: `todo` (To do), `in_progress` (In progress), `closed`.
- Kind (`task_type`, text): 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_id`, text): Only subtasks of this conversation.
- Due on or after (`due_after`, date and time): Only tasks due at or after this time.
- Due on or before (`due_before`, date and time): Only tasks due at or before this time.
- Page size (`limit`, number): How many to return, 2 to 50. Defaults to 25. From 2 to 50.
- Older than (`until`, date and time): Only tasks active before this time, to get the next page. Use 'Next page time' from the last page.

**Outputs**

- `count` (number): How many came back
- `next_until` (text): Pass as Older than to get the next page; empty on the last page
- `tasks` (list): The tasks

**Example output**

```json
{
  "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 (`organization`, text): Only this organization's. Leave empty for all.
- Page size (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `count` (number): How many came back
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page
- `teams` (list): The teams

**Example output**

```json
{
  "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 (`organization`, text): Only this organization's. Leave empty for all.
- Page size (`limit`, number): How many to return, 1 to 200. Missive's default is 50. From 1 to 200.
- Offset (`offset`, number): How many to skip, to get a later page. Use 'Next offset'. At least 0.

**Outputs**

- `count` (number): How many came back
- `me` (object): The connected user, if on this page
- `next_offset` (text): Pass as Offset to get the next page; empty on the last page
- `users` (list): The users

**Example output**

```json
{
  "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_address`, text, required): The sender's email address. It must be one of your Missive email addresses or aliases.
- From name (`from_name`, text): The name shown as the sender.
- To (`to`, text, required): Who to send it to. Separate several addresses with commas.
- Cc (`cc`, text): Addresses to copy, separated by commas.
- Bcc (`bcc`, text): Addresses to copy without the others seeing, separated by commas.
- Subject (`subject`, text): 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 (`body`, text, required): The message, as text or HTML.
- Reply in conversation (`conversation_id`, text): To reply, the conversation's id or Missive address. Leave empty to start a new conversation.
- Organization (`organization`, text): The organization to share a new conversation with. Leave empty to keep it private to you.
- Add my signature (`add_default_signature`, true/false): Add the signature of the address it is sent from.
- Send at (`send_at`, date and time): Send later, at this time. Leave empty to send right away.

**Outputs**

- `conversation_id` (text): The conversation it is in
- `draft` (object): The message, as Missive recorded it
- `draft_id` (text): The message's id

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from 'List contacts' or 'Create contact'.
- First name (`first_name`, text): The contact's first name.
- Last name (`last_name`, text): The contact's last name.
- Add email (`add_email`, text): An email address to add to the contact.
- Email type (`email_label`, text): What kind of address it is. Defaults to work. One of: `work` (Work (default)), `home`, `personal`, `other`.
- Add phone (`add_phone`, text): A phone number to add, with country code.
- Phone type (`phone_label`, text): What kind of number it is. Defaults to mobile. One of: `mobile` (Mobile (default)), `main`, `work`, `home`, `other`.
- Notes (`notes`, text): Notes about the contact.
- Starred (`starred`, true/false): Mark the contact as a favorite.

**Outputs**

- `contact` (object): The contact, as changed

**Example output**

```json
{
  "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_id`, text, required): The conversation's id or its Missive address, from 'List conversations' or an earlier step.
- State (`state`, text): Close or reopen it for everyone, or move it to the inbox. One of: `close`, `reopen`, `add_to_inbox` (Move to the inbox).
- Subject (`subject`, text): A new subject.
- Color (`color`, text): A new color for the conversation. One of: `good` (Green), `warning` (Yellow), `danger` (Red).
- Organization (`organization`, text): Needed to assign people or add shared labels: the organization they belong to.
- Team (`team`, text): Link the conversation to this team.
- Assign to (`add_assignees`, list): People to assign it to.
- Unassign (`remove_assignees`, list): People to take off it.
- Add shared labels (`add_shared_labels`, list): Labels to put on it.
- Remove shared labels (`remove_shared_labels`, list): Labels to take off it.

**Outputs**

- `conversation` (object): The conversation, as changed

**Example output**

```json
{
  "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_id`, text, required): The response's id, from 'List responses' or 'Create response'.
- Title (`title`, text): A new title.
- Subject (`subject`, text): The subject line the response fills in.
- Message (`body`, text): The text of the response, as text or HTML.

**Outputs**

- `response` (object): The response, as changed

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks' or 'Create task'.
- Title (`title`, text): A new title.
- Description (`description`, text): More detail about the task.
- State (`state`, text): Where the task stands. One of: `todo` (To do), `in_progress` (In progress), `closed`.
- Team (`team`, text): Move the task to this team.
- Assignees (`assignees`, list): The people responsible for the task.
- Due (`due_at`, date and time): When the task is due.

**Outputs**

- `task` (object): The task, as changed

**Example output**

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