Create Design

curl -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
  }'

curl -X POST https://api.v2.dealmachine.com/v1/mail/designs \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Custom Design",
    "html_front": "<div style=\"padding: 20px;\"><h1>Ready to Sell?</h1><p>We have buyers ready.</p></div>",
    "html_back": "<div style=\"padding: 20px;\"><p>Call us today!</p></div>",
    "auto_publish": true
  }'

POST

mail

designs

curl -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
  }'

curl -X POST https://api.v2.dealmachine.com/v1/mail/designs \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Custom Design",
    "html_front": "<div style=\"padding: 20px;\"><h1>Ready to Sell?</h1><p>We have buyers ready.</p></div>",
    "html_back": "<div style=\"padding: 20px;\"><p>Call us today!</p></div>",
    "auto_publish": true
  }'

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.

string

required

Design name

string

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

string

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

string

Custom HTML for the back side

string

default:"4x6"

Postcard size: 4x6, 6x9, 6x11

string

default:"landscape"

Orientation: landscape or portrait

string

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

string

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

boolean

default:"true"

Include a Street View image placeholder in the design

boolean

default:"false"

Automatically publish the design after creation

curl -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
  }'

curl -X POST https://api.v2.dealmachine.com/v1/mail/designs \
  -H "Authorization: Bearer dm_sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Custom Design",
    "html_front": "<div style=\"padding: 20px;\"><h1>Ready to Sell?</h1><p>We have buyers ready.</p></div>",
    "html_back": "<div style=\"padding: 20px;\"><p>Call us today!</p></div>",
    "auto_publish": true
  }'

List Designs Get Design

⌘I

Driving

Driving Assignments

Driving Targets

Driving Tags

Driving Notes

Mail

Mail Campaigns

Mail Designs

Mail Return Addresses

Mail Wallet

Mail Settings

Mail Analytics