Mirakl

Mirakl Messages API

The Messages API from Mirakl — 9 operation(s) for messages.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/messages List order and offer messages (deprecated) · M01 - List messages linked to orders and offers #
Ask an LLM
“Can I still list messages on orders and offers with the old messages endpoint?”
“Which customer messages did my shop receive on a given order, via the legacy API?”
Tell an agent
List legacy messages for order {order_id}.
Show legacy messages on offer {offer_id} since {start_date}.
GET /api/inbox/threads/{thread_id} Get an inbox thread · M10 - Retrieve a thread #
Ask an LLM
“How do I read every message in a conversation thread?”
“Can I fetch a single inbox thread by its ID?”
Tell an agent
Get thread {thread_id}.
Show the messages in thread {thread_id}.
GET /api/inbox/threads List inbox threads · M11 - List all threads #
Ask an LLM
“Which message threads have been updated since yesterday?”
“Can I list threads linked to a specific order?”
Tell an agent
List threads updated since {updated_since}.
Show threads on {entity_type} {entity_id}.
POST /api/inbox/threads Start a thread with the operator · M14 - Create a thread with the operator #
Ask an LLM
“How can a seller open a conversation with the marketplace operator?”
“Can I attach files to my first message to the operator?”
Tell an agent
Create an operator thread with {thread_input}.
Message the operator from shop {shop_id} with {thread_input}.
POST /api/inbox/threads/{thread_id}/message Reply to a thread · M12 - Reply to a thread #
Ask an LLM
“How do I reply in an existing message thread?”
“Is there a cap on the number of messages in a thread?”
Tell an agent
Reply to thread {thread_id} with {message_input}.
Send {message_input} with attachments {files} in thread {thread_id}.
GET /api/inbox/threads/{attachment_id}/download Download a thread attachment · M13 - Download an attachment #
Ask an LLM
“How do I download a file someone attached in a message thread?”
“Can I retrieve an inbox attachment by its ID?”
Tell an agent
Download attachment {attachment_id}.
Get the file for thread attachment {attachment_id}.
POST /api/orders/{order_id}/messages Post a message on an order (deprecated) · OR42 - Post a message on an order #
Ask an LLM
“Can I still post a message on an order with the old order-messages endpoint?”
“Does the legacy order message call create the customer if they don't exist?”
Tell an agent
Post legacy message {body} with subject {subject} on order {order_id}.
Send {body} to the shop on order {order_id} via the deprecated endpoint, as customer {customer_id}.
POST /api/orders/{order_id}/threads Start a thread on a product order · OR43 - Create a thread on an order #
Ask an LLM
“How do I open a conversation about a product order?”
“What's the size limit for attachments on an order message?”
Tell an agent
Create a thread on order {order_id} with {thread_input}.
Message the customer about order {order_id}: {thread_input}.
POST /api/mms/services/{service_code}/threads Start a thread on a service · SOF43 - Create a thread on a service #
Ask an LLM
“How can I open a conversation about a service listing?”
“Can a shop message the operator about one of its services?”
Tell an agent
Create a thread on service {service_code} with {thread_input}.
Open a message thread about service {service_code} for shop {shop_id}: {thread_input}.
POST /api/mms/orders/{order_id}/threads Start a thread on a service order · SOR43 - Create a thread on a service order #
Ask an LLM
“How do I message a customer about a booked service order?”
“Can I attach files when starting a thread on a service order?”
Tell an agent
Start a service-booking thread on service order {order_id} with {thread_input}.
Open a conversation about service order {order_id}: {thread_input}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mirakl/refs/heads/main/openapi/mirakl-messages-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/mirakl/refs/heads/main/openapi/_original/mirakl-connect-channel-webhooks-openapi.yaml

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/mirakl:mirakl-messages-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

mirakl-messages-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mirakl Messages API
  version: ''
  description: 'Operations tagged Messages across 3 of this provider''s published API definitions: mirakl-mmp-front-openapi.yaml, mirakl-mmp-seller-openapi.json, mirakl-mms-seller-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- description: URL to be replaced by your Mirakl instance URL
  url: https://your-instance.mirakl.net
tags:


# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mirakl/refs/heads/main/openapi/mirakl-messages-api-openapi.yml