Mapp Marketing Cloud

Mapp Marketing Cloud Whiteboard API

The Whiteboard API from Mapp Marketing Cloud — 8 operation(s) for whiteboard.

GitHub OpenAPI

Operations 8

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 /whiteboard/save Create or update a whiteboard · Creates or updates a whiteboard. #
Ask an LLM
“How do I save a customer journey whiteboard in the Audience Interaction Planner?”
“Is a whiteboard checked against the schema when I save it?”
Tell an agent
Save this whiteboard diagram.
Update my welcome journey whiteboard with these changes.
DELETE /whiteboard/delete Delete a whiteboard · Deletes a whiteboard by id. #
Ask an LLM
“What gets removed along with a whiteboard when I delete it?”
“Can I delete a whiteboard by its ID?”
Tell an agent destructive · confirm first
Delete whiteboard {id}.
Remove whiteboard {id} with its statistics and labels.
POST /whiteboard/publish Publish a whiteboard · Publishes a whiteboard. #
Ask an LLM
“How do I make a whiteboard journey live?”
“Is the diagram validated when a whiteboard is published?”
Tell an agent
Publish this whiteboard.
Take my cart abandonment whiteboard live.
GET /whiteboard/get Get a whiteboard with all versions · Returns a single whiteboard (all versions) by id #
Ask an LLM
“Can I see every version of a specific whiteboard?”
“How do I load one whiteboard by its ID?”
Tell an agent
Get whiteboard {id} with all its versions.
Open whiteboard {id}.
GET /whiteboard/listTemplates List whiteboard templates · Returns the active static whiteboard templates served by the Audience… #
Ask an LLM
“What starter templates are available for new whiteboards?”
“Which active whiteboard templates can I build a journey from?”
Tell an agent
List the available whiteboard templates.
Show me the journey templates I can start from.
GET /whiteboard/find Search whiteboards · Returns a paginated list of whiteboard summaries for the calling customer… #
Ask an LLM
“Which whiteboards have we created, most recently updated first?”
“Can I filter my whiteboards by name or status?”
Tell an agent
Find whiteboards named {nameFilter}.
List whiteboards with status {statusFilter}, {limit} per page.
GET /whiteboard/schema Get the whiteboard JSON schema · Returns the canonical whiteboard JSON Schema served by the Audience Interaction… #
Ask an LLM
“What JSON structure does a whiteboard need to follow?”
“Where can I get the canonical whiteboard schema?”
Tell an agent
Get the whiteboard JSON schema.
Show me the schema a whiteboard diagram must match.
POST /whiteboard/validate Validate a whiteboard without saving · Validates a whiteboard. #
Ask an LLM
“Can I check a whiteboard for errors before saving or publishing it?”
“What validation problems does my journey diagram have?”
Tell an agent
Validate this whiteboard and list any errors.
Run the full validation checks on my whiteboard draft.

Documentation

📖
Documentation
https://docs.mapp.com/apidocs/engage-api
📖
GettingStarted
https://docs.mapp.com/apidocs/getting-started-with-engage-api
📖
APIReference
https://docs.mapp.com/apidocs/engage-api-calls
📖
Documentation
https://docs.mapp.com/apidocs/analytics-api
📖
APIReference
https://docs.mapp.com/apidocs/analysis-analytics-api
📖
Documentation
https://docs.mapp.com/apidocs/product-catalog-api
📖
APIReference
https://docs.mapp.com/apidocs/product-catalog-api-api-reference
📖
Authentication
https://docs.mapp.com/apidocs/product-catalog-api-authentification
📖
Documentation
https://docs.mapp.com/apidocs/mapp-fashion-api-documentation

Specifications

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

Other Resources

🔗
Postman
https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/Analytics%20API.postman_collection.json
🔗
ChangeLog
https://docs.mapp.com/apidocs/changelog-mapp-fashion-api

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/mapp:mapp-whiteboard-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

mapp-whiteboard-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mapp Engage public Whiteboard API
  version: '1'
  description: 'Mapp Engage REST API (REST 2.0, incremental version v19). Assembled verbatim from the per-operation OpenAPI fragments Mapp publishes on each endpoint page of https://docs.mapp.com/apidocs/. The base URL is tenant-specific: take your Mapp Engage login host and append /api/rest/v19.'
  contact:
    name: Mapp Technical Support
    url: https://mapp.com/tech-support/
servers:
- url: /api/rest/v19
security:
- basicAuth: []
tags:
- name: Whiteboard
paths:
  /whiteboard/save:
    post:
      tags:
      - Whiteboard
      summary: Creates or updates a whiteboard.
      description: ''
      operationId: save
      responses:
        '200':
          description: The outcome of the save operation (UpsertResult).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpsertResult'
        '400':
          description: The supplied whiteboard JSON failed schema validation.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentAutomationPayload'
  /whiteboard/delete:
    delete:
      tags:
      - Whiteboard
      summary: Deletes a whiteboard by id.
      description: ''
      operationId: delete_5
      parameters:
      - name: id
        in: query
        description: ID of the whiteboard to delete
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '204':
          description: The deletion completed.
        '400':
          description: id was not supplied or was invalid, or no whiteboard exists for the supplied id.
  /whiteboard/publish:
    post:
      tags:
      - Whiteboard
      summary: Publishes a whiteboard.
      description: ''
      operationId: publish_2
      responses:
        '200':
          description: The structured activation result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivationResult'
        '400':
          description: The supplied DiagramData JSON failed schema validation, or no whiteboard exists for the specified id.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentPublishPayload'
  /whiteboard/get:
    get:
      tags:
      - Whiteboard
      summary: Returns a single whiteboard (all versions) by id
      description: ''
      operationId: get_6
      parameters:
      - name: id
        in: query
        description: ID of the whiteboard to return
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Pass-through whiteboard JSON (all versions).
          content:
            application/json:
              schema:
                type: string
        '400':
          description: id was not supplied or was invalid, or no whiteboard exists for the supplied id.
  /whiteboard/listTemplates:
    get:
      tags:
      - Whiteboard
      summary: Returns the active static whiteboard templates served by the Audience…
      description: ''
      operationId: listTemplates
      responses:
        '200':
          description: The active static whiteboard templates.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WhiteboardTemplate'
  /whiteboard/find:
    get:
      tags:
      - Whiteboard
      summary: Returns a paginated list of whiteboard summaries for the calling customer…
      description: ''
      operationId: find_3
      parameters:
      - name: nameFilter
        in: query
        description: Substring filter on whiteboard name (>= 3 chars)
        required: false
        schema:
          type: string
      - name: statusFilter
        in: query
        description: AutomationStatus value (DRAFT, ACTIVE, ...)
        required: false
        schema:
          type: string
      - name: sortByDate
        in: query
        description: ASC or DESC, applied to lastUpdateDate
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: 1-based page index, defaults to 1
        required: false
        schema:
          type: integer
          format: int64
      - name: limit
        in: query
        description: Page size, defaults to 100
        required: false
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: A page of whiteboard summaries and the total matching count.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhiteboardPage'
        '400':
          description: An invalid sort direction or status value was supplied.
  /whiteboard/schema:
    get:
      tags:
      - Whiteboard
      summary: Returns the canonical whiteboard JSON Schema served by the Audience Interaction…
      description: ''
      operationId: schema_2
      responses:
        '200':
          description: The raw JSON Schema document.
          content:
            application/json:
              schema:
                type: string
  /whiteboard/validate:
    post:
      tags:
      - Whiteboard
      summary: Validates a whiteboard.
      description: ''
      operationId: validate_2
      responses:
        '200':
          description: The structured validation result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResult'
        '400':
          description: The supplied JSON could not be parsed or the payload wrapper was malformed.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentAutomationPayload'
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication with a Mapp Engage system user of type API (or Hybrid).
x-apievangelist-provenance:
  method: searched
  generated: '2026-08-12'
  source: https://docs.mapp.com/apidocs/ (per-endpoint OpenAPI fragments)
  note: Union of the OpenAPI JSON fragments Mapp publishes on each endpoint page. Mapp does not serve one consolidated document at a public URL; the tenant-served Swagger lives at https://<your-engage-host>/apidoc/swagger.json and requires a tenant. Operation bodies, parameters, responses, tags, summaries and descriptions are verbatim from Mapp. The swagger/basePath/schemes/securityDefinitions envelope is added by API Evangelist from the published Getting Started guide; no operation content was authored.
  duplicate_operation_ids_suffixed: 30