MARTHA TRADE PTE. LTD. (Martha trade)

MARTHA TRADE PTE. LTD. (Martha trade) Mailboxes API

The Mailboxes API from MARTHA TRADE PTE. LTD. (Martha trade) — 11 operation(s) for mailboxes.

GitHub OpenAPI

Operations 13

GET /api/mailboxes/{mailbox_id}/outbound Settings #
POST /api/mailboxes/{mailbox_id}/outbound Configure #
POST /api/mailboxes/{mailbox_id}/outbound/incoming-credentials Enable With Incoming #
GET /api/mailboxes Mailboxes #
POST /api/mailboxes Connect #
POST /api/mailboxes/test-imap Test Imap #
PUT /api/mailboxes/{mailbox_id}/password Update Mailbox Password #
PUT /api/mailboxes/{mailbox_id}/folder-mode Enable Auto Folders #
POST /api/mailboxes/{mailbox_id}/disconnect Disconnect #
DELETE /api/mailboxes/{mailbox_id} Purge #
POST /api/mailboxes/{mailbox_id}/sync Sync #
POST /api/mailboxes/{mailbox_id}/monitoring Monitoring #
POST /api/mailboxes/{mailbox_id}/grok-delivery Grok Delivery #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/inboxmcp-ai/openapi/inboxmcp-ai-mailboxes-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/inboxmcp-ai/json-schema/inboxmcp-ai-mailbox-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/inboxmcp-ai/json-schema/inboxmcp-ai-outbound-setting-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/inboxmcp-ai/json-schema/inboxmcp-ai-grok-delivery-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/inboxmcp-ai/json-schema/inboxmcp-ai-imap-test-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/inboxmcp-ai/json-schema/inboxmcp-ai-monitoring-input-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/inboxmcp-ai:inboxmcp-ai-mailboxes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

inboxmcp-ai-mailboxes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Inboxmcp Ai Mailboxes API
  version: 0.2.0
  description: 'Operations tagged Mailboxes across 2 of this provider''s published API definitions: openapi.json, inboxmcp-ai-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Mailboxes
paths:
  /api/mailboxes/{mailbox_id}/outbound:
    get:
      summary: Settings
      operationId: settings_api_mailboxes__mailbox_id__outbound_get
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
    post:
      summary: Configure
      operationId: configure_api_mailboxes__mailbox_id__outbound_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OutboundSettingInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/outbound/incoming-credentials:
    post:
      summary: Enable With Incoming
      operationId: enable_with_incoming_api_mailboxes__mailbox_id__outbound_incoming_credentials_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes:
    get:
      summary: Mailboxes
      operationId: mailboxes_api_mailboxes_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
    post:
      summary: Connect
      operationId: connect_api_mailboxes_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MailboxInput'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/test-imap:
    post:
      summary: Test Imap
      operationId: test_imap_api_mailboxes_test_imap_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImapTestInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/password:
    put:
      summary: Update Mailbox Password
      operationId: update_mailbox_password_api_mailboxes__mailbox_id__password_put
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MailboxPasswordInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/folder-mode:
    put:
      summary: Enable Auto Folders
      operationId: enable_auto_folders_api_mailboxes__mailbox_id__folder_mode_put
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FolderModeInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/disconnect:
    post:
      summary: Disconnect
      operationId: disconnect_api_mailboxes__mailbox_id__disconnect_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}:
    delete:
      summary: Purge
      operationId: purge_api_mailboxes__mailbox_id__delete
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/sync:
    post:
      summary: Sync
      operationId: sync_api_mailboxes__mailbox_id__sync_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/monitoring:
    post:
      summary: Monitoring
      operationId: monitoring_api_mailboxes__mailbox_id__monitoring_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MonitoringInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
  /api/mailboxes/{mailbox_id}/grok-delivery:
    post:
      summary: Grok Delivery
      operationId: grok_delivery_api_mailboxes__mailbox_id__grok_delivery_post
      parameters:
      - name: mailbox_id
        in: path
        required: true
        schema:
          type: string
          title: Mailbox Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GrokDeliveryInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Mailboxes
components:
  schemas:
    MailboxInput:
      properties:
        address:
          type: string
          maxLength: 254
          minLength: 3
          title: Address
        provider:
          type: string
          enum:
          - demo
          - imap
          title: Provider
          default: demo
        platform:
          type: string
          enum:
          - demo
          - local
          - grok
          - chatgpt
          - muse
          title: Platform
          default: demo
        host:
          anyOf:
          - type: string
            maxLength: 253
          - type: 'null'
          title: Host
        username:
          anyOf:
          - type: string
            maxLength: 254
          - type: 'null'
          title: Username
        password:
          anyOf:
          - type: string
            maxLength: 1000
          - type: 'null'
          title: Password
        folder_mode:
          type: string
          enum:
          - auto
          - single
          title: Folder Mode
          default: auto
        folder:
          type: string
          maxLength: 255
          minLength: 1
          title: Folder
          default: INBOX
        initial_backfill:
          type: boolean
          title: Initial Backfill
          default: false
        initial_recent:
          anyOf:
          - type: integer
            maximum: 50.0
            minimum: 1.0
          - type: 'null'
          title: Initial Recent
        webhook_url:
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          title: Webhook Url
        webhook_secret:
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          title: Webhook Secret
      additionalProperties: false
      type: object
      required:
      - address
      title: MailboxInput
    MailboxPasswordInput:
      properties:
        password:
          type: string
          maxLength: 1000
          minLength: 1
          title: Password
      additionalProperties: false
      type: object
      required:
      - password
      title: MailboxPasswordInput
    GrokDeliveryInput:
      properties:
        delivery_mode:
          type: string
          enum:
          - single
          - batch_v1
          title: Delivery Mode
          default: single
        batch_compatible:
          type: boolean
          title: Batch Compatible
          default: false
        enabled:
          type: boolean
          title: Enabled
        expected_connection_updated_at:
          anyOf:
          - type: string
            maxLength: 100
            minLength: 1
          - type: 'null'
          title: Expected Connection Updated At
        confirmed_host:
          type: string
          maxLength: 253
          title: Confirmed Host
          default: api2.cursor.sh
      additionalProperties: false
      type: object
      required:
      - enabled
      title: GrokDeliveryInput
    OutboundSettingInput:
      properties:
        enabled:
          type: boolean
          title: Enabled
        host:
          anyOf:
          - type: string
            maxLength: 253
          - type: 'null'
          title: Host
        port:
          anyOf:
          - type: integer
          - type: 'null'
          title: Port
        security:
          anyOf:
          - type: string
            enum:
            - tls
            - starttls
          - type: 'null'
          title: Security
        username:
          anyOf:
          - type: string
            maxLength: 320
          - type: 'null'
          title: Username
        password:
          anyOf:
          - type: string
            maxLength: 4096
          - type: 'null'
          title: Password
      additionalProperties: false
      type: object
      required:
      - enabled
      title: OutboundSettingInput
    MonitoringInput:
      properties:
        enabled:
          type: boolean
          title: Enabled
        expected_connection_updated_at:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Expected Connection Updated At
        confirmed_host:
          type: string
          maxLength: 253
          title: Confirmed Host
          default: api2.cursor.sh
        interval_seconds:
          type: integer
          maximum: 3600.0
          minimum: 60.0
          title: Interval Seconds
          default: 60
      additionalProperties: false
      type: object
      required:
      - enabled
      title: MonitoringInput
    ImapTestInput:
      properties:
        host:
          type: string
          maxLength: 253
          minLength: 1
          title: Host
        username:
          type: string
          maxLength: 254
          minLength: 1
          title: Username
        password:
          type: string
          maxLength: 1000
          minLength: 1
          title: Password
        folder_mode:
          type: string
          enum:
          - auto
          - single
          title: Folder Mode
          default: auto
        folder:
          type: string
          maxLength: 255
          minLength: 1
          title: Folder
          default: INBOX
      additionalProperties: false
      type: object
      required:
      - host
      - username
      - password
      title: ImapTestInput
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FolderModeInput:
      properties:
        folder_mode:
          type: string
          const: auto
          title: Folder Mode
      additionalProperties: false
      type: object
      required:
      - folder_mode
      title: FolderModeInput
x-refined-from:
- openapi.json
- inboxmcp-ai-openapi.json
x-provenance:
  method: harvested
  publisher: MARTHA TRADE PTE. LTD. (Martha trade)
  source: https://app.inboxmcp.ai/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)