Mailmodo Contact Lists API

Manage the named contact lists used for segmentation and campaigns

Documentation

Specifications

Schemas & Data

Other Resources

OpenAPI Specification

mailmodo-contact-lists-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Mailmodo Campaigns Contact Lists API
  description: Mailmodo is an AI-powered interactive email marketing and automation platform. Its public REST API enables developers to manage contacts and contact lists, trigger transactional and broadcast campaigns built from AMP-for-Email templates, send custom events into journeys, list templates and campaigns, and fetch campaign reports. All requests are authenticated via an API key issued from the Mailmodo dashboard (Settings -> API Keys) and passed in the `mmApiKey` HTTP header.
  version: 1.0.0
  contact:
    name: Mailmodo
    url: https://www.mailmodo.com/developers/
servers:
- url: https://api.mailmodo.com
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Contact Lists
  description: Manage the named contact lists used for segmentation and campaigns
paths:
  /api/v1/getAllContactLists:
    get:
      tags:
      - Contact Lists
      summary: Get All Contact Lists
      description: Return the workspace's named contact lists with size and metadata.
      operationId: getAllContactLists
      responses:
        '200':
          description: Contact lists
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ContactList'
components:
  schemas:
    ContactList:
      type: object
      properties:
        listId:
          type: string
        listName:
          type: string
        contactsCount:
          type: integer
        createdAt:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: mmApiKey
      description: API key issued from the Mailmodo dashboard at https://manage.mailmodo.com/app/settings/apikey. Sent as the `mmApiKey` request header on every call.