skills.rest
surfingalien
surfingalienCOMMUNITY
Explore all skills by this author →
GitHub

poplar-direct-mail

Design HTML direct mail templates and send programmatic mailings via the Poplar API.

1|Updated May 6, 2026
Search Tags:#api#marketing automation#poplar#postcards#html templates#direct mail#merge tags
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill poplar-direct-mail-surfingalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: poplar-direct-mail
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/poplar-direct-mail
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill poplar-direct-mail-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve? Creating and sending personalized physical direct mail at scale requires handling print-ready HTML templates, merge tag personalization, and API-driven mailing triggers, which is complex to implement from scratch. ## Core Features & Use Cases - HTML Template Design: Build print-ready postcards, bi-folds, tri-folds, and letters with correct dimensions, bleed areas, and Poplar-compatible CSS constraints. - Personalization with Merge Tags: Use Liquid syntax to inject recipient names, promo codes, QR codes, and conditional offer tiers into mail pieces. - Programmatic Sending: Trigger single or batch mailings via the Poplar API using included Python scripts for single sends, CSV batch sends, and connection testing. - Use Case: A marketing team wants to send a win-back postcard campaign to 500 lapsed customers with unique promo codes. They upload a CSV, run the batch script with their campaign ID, and each recipient gets a personalized postcard. ## Quick Start Set your POPLAR_API_TOKEN environment variable and ask the assistant to send a test postcard to a recipient address using your Poplar campaign ID.

Frequently Asked Questions about poplar-direct-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a direct mail piece with the Poplar API?▼

Send a POST request to https://api.heypoplar.com/v1/mailing with your Bearer token, campaign_id, and recipient address fields. The included send_mailing.py script wraps this call and accepts command-line arguments for address, promo codes, and scheduling.

How do I send batch direct mail from a CSV file?▼

Use the send_batch.py script with --csv and --campaign-id arguments. The CSV needs address_1, city, state, and postal_code columns; any extra columns automatically become merge tags for personalization. Use --dry-run to preview before sending.

What CSS is supported in Poplar HTML templates?▼

Poplar templates require all CSS in a style tag in the head, absolute positioning for elements, and only in or px units. Image URLs must be absolute and publicly accessible, and fonts must come from Google Fonts or self-hosted ttf/woff files.

Does Poplar generate QR codes for mail pieces automatically?▼

No, Poplar does not auto-generate QR codes. You must pre-generate QR code images and pass the image URL through merge tags, using services like goqr.me, QRCode Monkey, or your own QR generation endpoint.

Why does my Poplar API request return a 401 error?▼

A 401 error means your API token is invalid or missing. Verify the POPLAR_API_TOKEN environment variable is set correctly, and note that test tokens only work with the /mailing endpoint, not /me or /campaigns.

What are the size requirements for a 4x6 postcard template?▼

A 4x6 postcard with bleed measures 4.25 x 6.25 inches, which is 1275 x 1875 pixels at 300 PPI. Keep content within a 0.25 inch safe zone from the trim edge and leave the back right side clear for Poplar's automatic address block.

Related Skills

Explore More Marketing & Sales Skills→
elihuvillarauselihuvillaraus
2

paid-social

Design full-funnel paid social campaigns for Meta, LinkedIn, and TikTok.

Community
Advanced
wanghaishengwanghaisheng
20

performance-analyzer

Analyzes influencer campaign metrics across reach, engagement, conversions, and sentiment.

Community
Intermediate
nexscope-ainexscope-ai
632

ecommerce-customer-retention

Analyze customer data to design engagement campaigns and loyalty programs.

Official
Intermediate
the-nam-shubthe-nam-shub
8

direct-mail-and-gifting

Plan personalized B2B direct mail and gifting campaigns with QR codes.

Community
Advanced