Create Design

Create a new postcard design. You can provide custom HTML directly or a text prompt for AI-powered HTML generation.

Instant generation: Unlike image-based mailing APIs, design generation from a prompt is instant. The generated HTML is returned immediately in the response — no polling required.

body namestringrequired

Design name

body promptstring

AI prompt to generate an HTML design. Either prompt or html_front is required.

body html_frontstring

Custom HTML for the front side. Either prompt or html_front is required.

body html_backstring

Custom HTML for the back side

body sizestringdefault: 4x6

Postcard size: 4x6, 6x9, 6x11

body orientationstringdefault: landscape

Orientation: landscape or portrait

body layoutstring

Layout preset (e.g., l-left-image, l-split-equal)

body themestring

Theme preset (e.g., professional, warm-friendly)

body include_street_viewbooleandefault: true

Include a Street View image placeholder in the design

body auto_publishbooleandefault: false

Automatically publish the design after creation

Request example

12345678910curl -X POST https://api.v2.dealmachine.com/v1/mail/designs \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Seller Outreach Card",
    "prompt": "A professional postcard for homeowners interested in selling. Warm colors, friendly tone. Include property image.",
    "size": "4x6",
    "include_street_view": true,
    "auto_publish": true
  }'