--- title: "Creating and Publishing a Whiteboard" slug: "engage-api-creating-and-publishing-a-whiteboard" updated: 2026-07-30T16:37:21Z published: 2026-07-30T16:40:14Z canonical: "docs.mapp.com/engage-api-creating-and-publishing-a-whiteboard" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Creating and Publishing a Whiteboard Whiteboards are the Engage tool for designing and automating marketing campaigns as visual, multi-step customer journeys — always-on programs that respond to contact behavior and attributes across channels. This use case shows how to build a Whiteboard and activate it through the Engage API, so you can create and deploy these automations programmatically instead of in the UI. ## Prerequisites Before you begin, make sure you have valid authorization credentials. See [Getting Started with Engage API](/v1-api/apidocs/getting-started-with-engage-api) for more information. A Whiteboard is first saved as a draft and then published. ## Procedure Optionally, list the available templates with `GET /whiteboard/listTemplates` to start from a template. Save the Whiteboard; the request body is a wrapper whose `json` field carries the diagram document as an escaped string. ```json POST 'https://your-engage-domain.com/api/rest/whiteboard/save' {  "json": "" } ``` The response returns the whiteboard's `id`. You can check the diagram with `POST /whiteboard/validate`. Publish it to make it live: ```json POST 'https://your-engage-domain.com/api/rest/whiteboard/publish' {  "automationId": ,  "diagramJson": "" } ``` ## Conclusion `save` returns the whiteboard `id`; `publish` activates it and rejects an invalid diagram with a **400** response. ## Related Topics [Save a whiteboard](/v1-api/apidocs/creates-or-updates-whiteboard-schema-validates-body-whiteboard-json-schema-1) [Publish a whiteboard](/v1-api/apidocs/publishes-a-whiteboard-schema-validates-the-diagramdata-json-1) [Validate a whiteboard](/v1-api/apidocs/validates-a-whiteboard-runs-the-full-model-level-validation-suite-1) [List whiteboard templates](/v1-api/apidocs/returns-active-static-whiteboard-templates-audience-interaction-planner-1) [Getting Started with Engage API](/v1-api/apidocs/getting-started-with-engage-api)