Rest API

Use the Missive REST API to enrich conversations, automate drafts, sync contacts, and more.

The Missive API lets you enrich Missive conversations with content from anywhere on the web. You can also automate tasks such as creating and sending drafts, syncing contacts and more.

Example of a post created using the REST API

e.g. An action in another app inserting a post in a conversation.

Basics

The API is a collection of endpoints with a method (eg. POST) and a URL in the form of:

Authentication

To start using the API, you first need to get your API token. Get it from your Missive preferences, click the API tab, then the Create a new token link.

circle-info

You need to be part of an organization subscribed to the Productive planarrow-up-right in order to generate API tokens.

You must transmit your user token as a Bearer token in the Authorization HTTP header.

Responses

All API responses are formatted as JSONarrow-up-right, including errors. Successful POST requests may return the 201arrow-up-right status code with no body.

Evaluating responses

You should infer the success of your requests from the returned HTTP status code. A successful request will return either a 200arrow-up-right or 201arrow-up-right status code.

POST bodies

You must explicitly send POST requests with Content-Type: application/json.

Resource IDs

To interact with resources via the API, you will need those resource's ID. For instance, if you want to apply a label to a conversation when creating a post, you will need the label ID. You can get those resources IDs by opening the API settings and clicking on the Resource IDs tab.

Find resource IDs in your API settings

Settings > API > Resource IDs

Last updated on February 24, 2020

chevron-rightNeed more specific answers?hashtag

Last updated