OpenAPI Specification
openapi: 3.0.3
info:
title: Missive REST Analytics Contact Books API
description: The Missive REST API allows developers to manage conversations, messages, contacts, drafts, labels, and analytics programmatically. Authentication uses Bearer tokens (personal access tokens) generated in Missive preferences. The API requires a Productive plan or higher to generate API tokens. Responses are JSON-formatted with HTTP 200 or 201 success codes.
version: '1'
contact:
name: Missive Support
url: https://missiveapp.com/help
termsOfService: https://missiveapp.com/terms
servers:
- url: https://public.missiveapp.com/v1
description: Missive REST API v1
security:
- bearerAuth: []
tags:
- name: Contact Books
description: List available contact books
paths:
/contact_books:
get:
operationId: listContactBooks
summary: List Contact Books
description: List contact books the authenticated user has access to.
tags:
- Contact Books
parameters:
- name: limit
in: query
description: Maximum number of results (default 50, max 200)
schema:
type: integer
default: 50
maximum: 200
- name: offset
in: query
schema:
type: integer
responses:
'200':
description: Array of contact book objects
content:
application/json:
schema:
$ref: '#/components/schemas/ContactBooksResponse'
components:
schemas:
ContactBook:
type: object
properties:
id:
type: string
name:
type: string
shared:
type: boolean
ContactBooksResponse:
type: object
properties:
contact_books:
type: array
items:
$ref: '#/components/schemas/ContactBook'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Personal access token generated in Missive preferences. Format: Bearer missive_pat-[token]. Requires Productive plan or higher.'
externalDocs:
description: Missive Developer Documentation
url: https://missiveapp.com/docs/developers/rest-api