Swift Missive’s API Specification

Author: Dave Cline
Posted: 9/14/2025

At the bottom of this page is the Swagger / OpenAPI documentation on Swift Missive’s API. Anything you can do from the Swift Missive user interface, you can also do by using these endpoints.

To play around with the api: click Authorize, copy-paste the API Key listed into the box, click Authorize, then click Close. The API calls on this page will now use the correct API key for the demo account. Once you have Authorized correctly, you can use the "Try it out" buttons in the individual endpoint docs to make requests to the API.

Using the API with your account

Every Swift Missive customer gets their own endpoints as well as their own API key, so using your account’s API key with another account’s endpoints (such as the demo endpoints on this page) will not work. You can follow these instructions to figure out how to use the API for your own account instead of the demo account.

  1. Get your account’s API key and endpoints

    Logging into Swift Missive is the easiest way to get your API key and personalized endpoints. Here is an example login call:

    The examples below use curl, a standard command-line tool for making HTTP requests.

    curl 'https://avcs27n2kc.execute-api.us-east-1.amazonaws.com/login' -H 'content-type: application/json' -H 'origin: https://swiftmissive.com' --data-raw '{"email":"YOUR_LOGIN_EMAIL","password":"YOUR_LOGIN_PASSWORD"}'

    Here is an example response:

    {
      "api_client_key": "12345678-1234-1234-1234-123456789123",
      "integration_key": "I12345678-1234-1234-1234-123456789123",
      "integration_key2": "I12345678-1234-1234-1234-123456789123",
      "endpoints": {
        "api_user_gateway": "https://aaaaaaaaaa.execute-api.us-east-1.amazonaws.com",
        "api_template_gateway": "https://bbbbbbbbbb.execute-api.us-east-1.amazonaws.com",
        "api_senderpersona_gateway": "https://cccccccccc.execute-api.us-east-1.amazonaws.com",
        "api_scheduler_gateway": "https://dddddddddd.execute-api.us-east-1.amazonaws.com",
        "api_reporting_gateway": "https://eeeeeeeeeee.execute-api.us-east-1.amazonaws.com",
        "api_segment_gateway": "https://fffffffffff.execute-api.us-east-1.amazonaws.com",
        "...": "..."
      }
    }
  2. Use your endpoints and API key together to make calls to the API

    Note that every entity in Swift Missive holds its functionality in one or two services that often have different domain names. For example:

    • To add, alter, or delete contacts for your account, for instance, you would need to use the endpoint with the key "api_user_gateway" from the login response.
      i.e. via a POST https://aaaaaaaaaa.execute-api.us-east-1.amazonaws.com/users
    • Alternatively, to add, alter, or delete, templates, you would need to use the "api_template_gateway" endpoint instead.
      i.e. via a POST https://bbbbbbbbbb.execute-api.us-east-1.amazonaws.com/templates

Interactive API docs load after hydration on this page.