Guide

API Documentation

Getting started

The Missive API lets you enrich Missive conversations with content from anywhere on the web.

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.

Note You need to be part of an organization subscribed to the Productive plan in order to generate API tokens.

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":{}}


Last updated on July 4, 2018

Need more specific answers?

Contact us via our Help Center