Builder launch

Please follow these steps in order to launch the builder with valid pre-requisites. Endpoints were made in accordance with UI provided here, https://mailmailmail.dev.xenioo.com/ (steps for creating campaign)

Builder API on this host: Swagger UI (/documentation) — lists, templates, newsletters, launch token. Main App / CRUD (login, campaigns list): Authentication → Login user and Newsletters on the hosted Swagger.

All requests to this builder host (except login on the CRUD host) require Authorization: Bearer <access_token>. Use Builder API documentation to try builder endpoints below.

Step 1: Get lists and segments

From the returned data, select at least one list (and optionally segments) for the campaign.

• API documentation → Lists/Segments → Fetch lists
  GET https://builder.marketingplatform.com/api/v1/lists
• API documentation → Lists/Segments → Get segments
  GET https://builder.marketingplatform.com/api/v1/segments

Step 2: Choose one source for the campaign

Pick one of the following and get the ID (or use blank):

• From template: API documentation → Templates
  GET https://builder.marketingplatform.com/api/templates — select one templateId from the response.
• From previous campaign: Swagger → Newsletters (list)
  GET https://staging-swagger-api.mailmailmaildev.net/api/v1/newsletters — select one newsletterid (campaign ID) from the response.
• Blank template: API documentation → Newsletters → Default template
  GET https://builder.marketingplatform.com/api/newsletters/templates/default — use this when creating a blank campaign (no template/campaign ID).

Step 3: Store the campaign (create newsletter)

API documentation → Newsletters → Create newsletter

• POST https://builder.marketingplatform.com/api/newsletters
• Body: name, subject, lists, segments, and exactly one of: templateId, campaignId, or blankTemplate: true.
• Response includes the new newsletterid — use it in Step 4.

Step 4: Get launch token & open the builder

• API documentation → Builder → Get launch token
• POST https://builder.marketingplatform.com/api/builder/launchToken — body: { "newsletterid": <id from step 3> }. Response: token (and newsletterid).
• Open the builder: https://builder.marketingplatform.com/builder/launch?token=<token> (same URL for new tab or iframe). The launch page redirects to the builder with token and newsletterid in the URL so the campaign is set explicitly.