Mirakl

Mirakl Channel API

The Channel API from Mirakl — 1 operation(s) for channel.

Documentation GitHub OpenAPI

Operations 1

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

POST /v1/channels Create or update channels · SELLER_ACCOUNT_CHANNEL_UPSERT - Create or update channels #

Ask an LLM

“How do I register sales channels for seller accounts?”

“Can I update existing channels and add new ones in one request?”

Tell an agent

Upsert channels {channels}.

Create or update these channels {channels}.

Specifications

⚙

OpenAPI

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

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-channel-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

openapi: 3.2.0
info:
  description: '{% partial file="/partial-content/product/account-channel-platform/rest/connector/openapi-description.md" /%}'
  title: Mirakl Account Platform Channel API
  version: ''
servers:
- description: Account Channel Platform API
  url: https://account.mirakl.net/api/channel-platform
tags:
- name: Channel
paths:
  /v1/channels:
    post:
      description: 'Description


        Api to create or update channels'
      operationId: SELLER_ACCOUNT_CHANNEL_UPSERT
      parameters: []
      requestBody:
        content:
          application/json:
            examples:
              application/json-0:
                summary: Example with business values (application/json)
                value:
                  channels:
                  - external_id: env1-test
                    name: Awesome marketplace
                    status: AVAILABLE
                    url: https://env1-test.mirakl.net
              application/json-auto:
                summary: Complete example with value types (application/json)
                value:
                  channels:
                  - external_id: string
                    name: string
                    status: string
                    url: string
            schema:
              $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Request'
      responses:
        '201':
          content:
            application/json:
              examples:
                application/json-auto:
                  summary: Complete example with value types (application/json)
                  value:
                    channels:
                    - external_id: string
                      id: string
                      name: string
                      status: AVAILABLE
                      url: string
                      vendor: string
              schema:
                type: object
                $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_201'
          description: Channels created or updated
        '401':
          content:
            application/json:
              examples:
                application/json-auto:
                  summary: Complete example with value types (application/json)
                  value:
                    channels:
                    - external_id: string
                      id: string
                      name: string
                      status: AVAILABLE
                      url: string
                      vendor: string
              schema:
                type: object
                $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_401'
          description: Invalid app-auth token
        '403':
          content:
            application/json:
              examples:
                application/json-auto:
                  summary: Complete example with value types (application/json)
                  value:
                    channels:
                    - external_id: string
                      id: string
                      name: string
                      status: AVAILABLE
                      url: string
                      vendor: string
              schema:
                type: object
                $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_403'
          description: Unknown connector
      summary: SELLER_ACCOUNT_CHANNEL_UPSERT - Create or update channels
      tags:
      - Channel
components:
  schemas:
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_403:
      type: object
      properties:
        channels:
          type: array
          description: channels
          items:
            $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_403_Channels'
      required:
      - channels
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_201_Channels:
      type: object
      properties:
        external_id:
          type: string
          description: Channel external id
        id:
          type: string
          description: Channel id
        name:
          type: string
          description: Channel name
        status:
          type: string
          description: 'Channel status


            Enum: `"AVAILABLE"`

            '
        url:
          type: string
          description: Channel url
        vendor:
          type: string
          description: Channel vendor
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_401:
      type: object
      properties:
        channels:
          type: array
          description: channels
          items:
            $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_401_Channels'
      required:
      - channels
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_401_Channels:
      type: object
      properties:
        external_id:
          type: string
          description: Channel external id
        id:
          type: string
          description: Channel id
        name:
          type: string
          description: Channel name
        status:
          type: string
          description: 'Channel status


            Enum: `"AVAILABLE"`

            '
        url:
          type: string
          description: Channel url
        vendor:
          type: string
          description: Channel vendor
    SELLER_ACCOUNT_CHANNEL_UPSERT_Request:
      type: object
      properties:
        channels:
          type: array
          description: Channels to upsert
          items:
            $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Request_Channels'
      required:
      - channels
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_403_Channels:
      type: object
      properties:
        external_id:
          type: string
          description: Channel external id
        id:
          type: string
          description: Channel id
        name:
          type: string
          description: Channel name
        status:
          type: string
          description: 'Channel status


            Enum: `"AVAILABLE"`

            '
        url:
          type: string
          description: Channel url
        vendor:
          type: string
          description: Channel vendor
    SELLER_ACCOUNT_CHANNEL_UPSERT_Response_201:
      type: object
      properties:
        channels:
          type: array
          description: channels
          items:
            $ref: '#/components/schemas/SELLER_ACCOUNT_CHANNEL_UPSERT_Response_201_Channels'
      required:
      - channels
    SELLER_ACCOUNT_CHANNEL_UPSERT_Request_Channels:
      type: object
      description: Channels to upsert
      properties:
        external_id:
          type: string
          description: Channel external id
        name:
          type: string
          description: Channel name
        status:
          type: string
          description: Channel status
        url:
          type: string
          description: Channel url
          pattern: ''
      required:
      - external_id
      - name
      - status
      - url
  securitySchemes:
    OAuth-2:
      description: For more information, see our [Authentication System documentation](https://help.mirakl.com/docs/customers/page/topics/Mirakl/partners_integration/authentication_system.htm)
      flows:
        authorizationCode:
          authorizationUrl: https://auth.mirakl.net/authorize
          refreshUrl: https://auth.mirakl.net/oauth/token
          scopes: {}
          tokenUrl: https://auth.mirakl.net/oauth/token
      type: oauth2
x-group-parameters: true