Getting started
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.
Basics
The API is a collection of endpoints with a method (eg. POST) and a URL in the form of https://public.missiveapp.com/v1/:endpoint_name.
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.
You must transmit your user token as a Bearer token in the Authorization HTTP header.
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer 140a62b5-57ce-4e63-a88e-38890f8079a9
Responses
All API responses are formatted as JSON, including errors. Successful POST requests may return the 201 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 200 or 201 status code.
POST bodies
You must explicitly send POST requests with Content-Type: application/json.
POST /v1/drafts
Host: public.missiveapp.com
Authorization: Bearer 140a62b5-57ce-4e63-a88e-38890f8079a9
Content-Type: application/json
{"drafts":{}}
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.
Last updated on February 24, 2020
