[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M748MEZ2DYGC53TAG35A5E2H":3,"skill-same:01M748MEZ2DYGC53TAG35A5E2H":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M748MEZ2DYGC53TAG35A5E2H","poplar-direct-mail",null,"Design and send programmatic direct mail using Poplar's HTML templates and API. Use for creating dynamic mail pieces (postcards, bifolds, trifolds, letters) with personalization and triggering mail via API.","surfingalien\u002FFinSurfing","surfingalien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F138259559?v=4","01M71XACCFHNXK70BHYFHFT657","01M71XACDJSV4YA5NZ191F1C8C",1,"MIT","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: poplar-direct-mail\ndescription: Design and send programmatic direct mail using Poplar's HTML templates and API. Use for creating dynamic mail pieces (postcards, bifolds, trifolds, letters) with personalization and triggering mail via API.\n---\n\n# Poplar Direct Mail\n\n## Overview\n\nDesign professional direct mail creative using Poplar's HTML template system and send programmatic mail pieces via their API. This skill covers template creation with dynamic personalization, API integration for triggered mailings, and creative best practices for high-converting direct mail campaigns.\n\n## When to Use\n\n- Creating HTML templates for direct mail postcards, bi-folds, tri-folds, or letters\n- Building triggered\u002Fprogrammatic direct mail campaigns\n- Integrating direct mail into marketing automation workflows\n- Designing personalized mail pieces with dynamic content (names, offers, QR codes)\n- Sending transactional mail (receipts, confirmations, statements)\n- Setting up abandoned cart or win-back mail campaigns\n\n## Prerequisites\n\n- Poplar account ([heypoplar.com](https:\u002F\u002Fheypoplar.com))\n- API access token from [Poplar Credentials](https:\u002F\u002Fapp.heypoplar.com\u002Fcredentials)\n- Python 3.9+ (for scripts)\n- `requests` package\n\n## Installation\n\n```bash\npip install requests\n```\n\nSet your API token:\n\n```bash\n# Test token (for development - only works with mailing endpoint)\nexport POPLAR_API_TOKEN=\"test_your_token_here\"\n\n# Production token (for live mailings)\nexport POPLAR_API_TOKEN=\"your_production_token_here\"\n```\n\n## Mail Formats & Dimensions\n\n### Postcards\n\n| Size | Final Trim | With Bleed | Pixels (300 PPI) |\n|------|------------|------------|------------------|\n| 4\" x 6\" | 4\" x 6\" | 4.25\" x 6.25\" | 1275 x 1875 |\n| 6\" x 9\" | 6\" x 9\" | 6.25\" x 9.25\" | 1875 x 2775 |\n| 6\" x 11\" | 6\" x 11\" | 6.25\" x 11.25\" | 1875 x 3375 |\n\n**Best for:** Retargeting, time-sensitive promotions, simple messaging, direct mail newcomers\n\n### Bi-folds\n\n| Format | Pixels (300 PPI) |\n|--------|------------------|\n| Short-fold (folds left to right) | 1725 x 5175 |\n| Long-fold (folds top to bottom) | 3375 x 2625 |\n\n**Best for:** Prospecting campaigns, new product launches, complex value propositions\n\n### Tri-folds\n\n| Format | Pixels (300 PPI) |\n|--------|------------------|\n| Standard Tri-fold | 2625 x 4987 |\n\n**Best for:** Multiple product selections, detailed information, catalogs\n\n### Letters\n\n| Format | Dimensions |\n|--------|------------|\n| 8.5\" x 11\" (Color or B&W) | 612 x 792 px (no bleed required) |\n\n**Best for:** Financial\u002Finsurance, sensitive content, transactional mailings, professional communications\n\n## HTML Template Structure\n\n### Basic Template\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Open+Sans:wght@400;600;700&display=swap\"\n        rel=\"stylesheet\" type=\"text\u002Fcss\">\n  \u003Cstyle>\n    * {\n      margin: 0;\n      padding: 0;\n      box-sizing: border-box;\n    }\n\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Open Sans', sans-serif;\n    }\n\n    .background {\n      position: absolute;\n      width: 100%;\n      height: 100%;\n      background-image: url('https:\u002F\u002Fyour-hosted-image.com\u002Fbackground.png');\n      background-size: cover;\n    }\n\n    .headline {\n      position: absolute;\n      top: 0.5in;\n      left: 0.375in;\n      font-size: 28pt;\n      font-weight: 700;\n      color: #1a1a1a;\n    }\n\n    .personalized-text {\n      position: absolute;\n      top: 1.2in;\n      left: 0.375in;\n      font-size: 14pt;\n      color: #333333;\n    }\n\n    .offer-box {\n      position: absolute;\n      bottom: 1in;\n      left: 0.375in;\n      width: 3.5in;\n      padding: 0.25in;\n      background-color: #ff6b35;\n      color: white;\n      text-align: center;\n      font-size: 18pt;\n      font-weight: 600;\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"background\">\u003C\u002Fdiv>\n  \u003Cdiv class=\"headline\">Special Offer Inside!\u003C\u002Fdiv>\n  \u003Cdiv class=\"personalized-text\">\n    Hi {{recipient.first_name | default: \"Friend\"}},\n  \u003C\u002Fdiv>\n  \u003Cdiv class=\"offer-box\">\n    Use code: {{promotion.promo_code}}\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### CSS Requirements\n\n| Requirement | Details |\n|-------------|---------|\n| CSS Location | All styles in `\u003Cstyle>` tag within `\u003Chead>` |\n| Positioning | Use `position: absolute` for all elements |\n| Units | Only `in` (inches) or `px` (pixels) - no `em`, `rem`, `vw`, `vh` |\n| Image URLs | Absolute URLs only (must be publicly accessible) |\n| Fonts | Google Fonts or self-hosted `.ttf`\u002F`.woff` files |\n\n### Font Implementation\n\n**Google Fonts (recommended):**\n\n```html\n\u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Montserrat:wght@400;600;700&display=swap\"\n      rel=\"stylesheet\" type=\"text\u002Fcss\">\n```\n\n**Custom fonts:**\n\n```css\n@font-face {\n  font-family: \"CustomFont\";\n  src: url(\"https:\u002F\u002Fyour-domain.com\u002Ffonts\u002FCustomFont.ttf\") format(\"truetype\");\n}\n```\n\n## Merge Tags & Personalization\n\n### Recipient Data\n\n```liquid\n{{recipient.first_name}}      \u003C!-- First name or \"Current Resident\" -->\n{{recipient.last_name}}       \u003C!-- Last name -->\n{{recipient.full_name}}       \u003C!-- Full name -->\n{{recipient.address_1}}       \u003C!-- Street address -->\n{{recipient.city}}            \u003C!-- City -->\n{{recipient.state}}           \u003C!-- State -->\n{{recipient.postal_code}}     \u003C!-- ZIP code -->\n```\n\n### Promotion Codes\n\n```liquid\n{{promotion.promo_code}}      \u003C!-- Unique promo code -->\n{{promotion.qr_url}}          \u003C!-- URL for QR code generation -->\n```\n\n### Location-Based\n\n```liquid\n{{location.city}}             \u003C!-- Recipient's city -->\n{{location.state}}            \u003C!-- Recipient's state -->\n{{location.store_address}}    \u003C!-- Nearest store address -->\n```\n\n### Custom Data\n\n```liquid\n{{custom.purchase_amount}}    \u003C!-- Custom field from your data -->\n{{custom.product_name}}       \u003C!-- Product purchased -->\n{{custom.loyalty_tier}}       \u003C!-- Customer tier -->\n```\n\n## Liquid Template Logic\n\n### Conditional Content\n\n```liquid\n{% if recipient.first_name %}\n  Hi {{recipient.first_name | capitalize}},\n{% else %}\n  Dear Valued Customer,\n{% endif %}\n```\n\n### Offer Tiers Based on Purchase History\n\n```liquid\n{% if custom.lifetime_value >= 500 %}\n  \u003Cdiv class=\"offer\">Enjoy 25% off your next order!\u003C\u002Fdiv>\n{% elsif custom.lifetime_value >= 200 %}\n  \u003Cdiv class=\"offer\">Take 15% off your next purchase!\u003C\u002Fdiv>\n{% else %}\n  \u003Cdiv class=\"offer\">Get $10 off orders over $50!\u003C\u002Fdiv>\n{% endif %}\n```\n\n### Rolling Expiration Dates\n\n```liquid\n\u003C!-- 30 days from print date -->\nExpires: {{ \"now\" | date: \"%s\" | plus: 2592000 | date: \"%B %e, %Y\" }}\n\n\u003C!-- 90 days from print date -->\nExpires: {{ \"now\" | date: \"%s\" | plus: 7776000 | date: \"%B %e, %Y\" }}\n```\n\n### Text Formatting Filters\n\n```liquid\n{{ recipient.first_name | capitalize }}     \u003C!-- Capitalizes first letter -->\n{{ recipient.first_name | upcase }}         \u003C!-- ALL CAPS -->\n{{ recipient.first_name | downcase }}       \u003C!-- all lowercase -->\n{{ custom.price | money }}                  \u003C!-- Format as currency -->\n```\n\n## API Reference\n\n### Authentication\n\nAll requests require a Bearer token:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_TOKEN\" \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fme\n```\n\n### Create Mailing\n\n**Endpoint:** `POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing`\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"campaign_id\": \"your-campaign-id\",\n    \"creative_id\": \"your-creative-id\",\n    \"recipient\": {\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Smith\",\n      \"address_1\": \"123 Main Street\",\n      \"address_2\": \"Apt 4B\",\n      \"city\": \"San Francisco\",\n      \"state\": \"CA\",\n      \"postal_code\": \"94102\"\n    },\n    \"merge_tags\": {\n      \"promo_code\": \"SAVE20\",\n      \"expiration_date\": \"December 31, 2024\"\n    }\n  }'\n```\n\n**Response (201 Created):**\n\n```json\n{\n  \"id\": \"mailing-uuid\",\n  \"campaign_id\": \"campaign-uuid\",\n  \"creative_id\": \"creative-uuid\",\n  \"state\": \"processing\",\n  \"front_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Ffront.png\",\n  \"back_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Fback.png\",\n  \"pdf_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Fproof.pdf\",\n  \"total_cost\": \"0.89\",\n  \"created_at\": \"2024-01-15T10:30:00Z\"\n}\n```\n\n### Schedule Future Mailing\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"campaign_id\": \"your-campaign-id\",\n    \"recipient\": {\n      \"full_name\": \"John Doe\",\n      \"address_1\": \"456 Oak Avenue\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"postal_code\": \"78701\"\n    },\n    \"send_at\": \"2024-02-01T09:00:00Z\"\n  }'\n```\n\n### Get Mailing Status\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing\u002F:id`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing\u002FMAILING_ID \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### List Campaigns\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaigns`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaigns \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### List Campaign Creatives\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaign\u002F:id\u002Fcreatives`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaign\u002FCAMPAIGN_ID\u002Fcreatives \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### Add to Do Not Mail List\n\n**Endpoint:** `POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fdo-not-mail`\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fdo-not-mail \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"email\": \"customer@example.com\",\n    \"address\": {\n      \"address_1\": \"123 Main St\",\n      \"postal_code\": \"94102\"\n    }\n  }'\n```\n\n## Python Scripts\n\n### Send Single Mailing\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Send a single direct mail piece via Poplar API.\"\"\"\n\nimport os\nimport requests\nimport argparse\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef send_mailing(\n    campaign_id: str,\n    recipient: dict,\n    creative_id: str = None,\n    merge_tags: dict = None,\n    send_at: str = None\n) -> dict:\n    \"\"\"Send a mailing via Poplar API.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        raise ValueError(\"POPLAR_API_TOKEN environment variable not set\")\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Content-Type\": \"application\u002Fjson\"\n    }\n\n    payload = {\n        \"campaign_id\": campaign_id,\n        \"recipient\": recipient\n    }\n\n    if creative_id:\n        payload[\"creative_id\"] = creative_id\n    if merge_tags:\n        payload[\"merge_tags\"] = merge_tags\n    if send_at:\n        payload[\"send_at\"] = send_at\n\n    response = requests.post(\n        f\"{POPLAR_API_URL}\u002Fmailing\",\n        headers=headers,\n        json=payload\n    )\n    response.raise_for_status()\n    return response.json()\n\n\ndef main():\n    parser = argparse.ArgumentParser(description=\"Send a Poplar direct mail piece\")\n    parser.add_argument(\"--campaign-id\", required=True, help=\"Campaign ID\")\n    parser.add_argument(\"--creative-id\", help=\"Creative ID (optional)\")\n    parser.add_argument(\"--first-name\", required=True, help=\"Recipient first name\")\n    parser.add_argument(\"--last-name\", required=True, help=\"Recipient last name\")\n    parser.add_argument(\"--address\", required=True, help=\"Street address\")\n    parser.add_argument(\"--city\", required=True, help=\"City\")\n    parser.add_argument(\"--state\", required=True, help=\"State (2-letter code)\")\n    parser.add_argument(\"--zip\", required=True, help=\"ZIP code\")\n    parser.add_argument(\"--promo-code\", help=\"Promo code merge tag\")\n\n    args = parser.parse_args()\n\n    recipient = {\n        \"first_name\": args.first_name,\n        \"last_name\": args.last_name,\n        \"address_1\": args.address,\n        \"city\": args.city,\n        \"state\": args.state,\n        \"postal_code\": args.zip\n    }\n\n    merge_tags = {}\n    if args.promo_code:\n        merge_tags[\"promo_code\"] = args.promo_code\n\n    result = send_mailing(\n        campaign_id=args.campaign_id,\n        recipient=recipient,\n        creative_id=args.creative_id,\n        merge_tags=merge_tags if merge_tags else None\n    )\n\n    print(f\"Mailing created: {result['id']}\")\n    print(f\"Status: {result['state']}\")\n    print(f\"Cost: ${result['total_cost']}\")\n    print(f\"PDF Preview: {result['pdf_url']}\")\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n### Batch Send from CSV\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Send batch mailings from a CSV file.\"\"\"\n\nimport os\nimport csv\nimport time\nimport requests\nimport argparse\nfrom typing import Generator\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef read_recipients(csv_path: str) -> Generator[dict, None, None]:\n    \"\"\"Read recipients from CSV file.\"\"\"\n    with open(csv_path, 'r') as f:\n        reader = csv.DictReader(f)\n        for row in reader:\n            yield {\n                \"recipient\": {\n                    \"first_name\": row.get(\"first_name\", \"\"),\n                    \"last_name\": row.get(\"last_name\", \"\"),\n                    \"address_1\": row.get(\"address_1\", \"\"),\n                    \"address_2\": row.get(\"address_2\", \"\"),\n                    \"city\": row.get(\"city\", \"\"),\n                    \"state\": row.get(\"state\", \"\"),\n                    \"postal_code\": row.get(\"postal_code\", \"\")\n                },\n                \"merge_tags\": {\n                    k: v for k, v in row.items()\n                    if k not in [\"first_name\", \"last_name\", \"address_1\",\n                                 \"address_2\", \"city\", \"state\", \"postal_code\"]\n                }\n            }\n\n\ndef send_batch(\n    csv_path: str,\n    campaign_id: str,\n    creative_id: str = None,\n    delay: float = 0.1\n) -> tuple[int, int]:\n    \"\"\"Send batch mailings from CSV.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        raise ValueError(\"POPLAR_API_TOKEN environment variable not set\")\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Content-Type\": \"application\u002Fjson\"\n    }\n\n    success_count = 0\n    error_count = 0\n\n    for record in read_recipients(csv_path):\n        payload = {\n            \"campaign_id\": campaign_id,\n            \"recipient\": record[\"recipient\"]\n        }\n\n        if creative_id:\n            payload[\"creative_id\"] = creative_id\n        if record[\"merge_tags\"]:\n            payload[\"merge_tags\"] = record[\"merge_tags\"]\n\n        try:\n            response = requests.post(\n                f\"{POPLAR_API_URL}\u002Fmailing\",\n                headers=headers,\n                json=payload\n            )\n            response.raise_for_status()\n            success_count += 1\n            print(f\"Sent to {record['recipient']['first_name']} {record['recipient']['last_name']}\")\n        except requests.exceptions.RequestException as e:\n            error_count += 1\n            print(f\"Error sending to {record['recipient']}: {e}\")\n\n        time.sleep(delay)\n\n    return success_count, error_count\n\n\ndef main():\n    parser = argparse.ArgumentParser(description=\"Send batch Poplar mailings from CSV\")\n    parser.add_argument(\"--csv\", required=True, help=\"Path to CSV file\")\n    parser.add_argument(\"--campaign-id\", required=True, help=\"Campaign ID\")\n    parser.add_argument(\"--creative-id\", help=\"Creative ID (optional)\")\n    parser.add_argument(\"--delay\", type=float, default=0.1, help=\"Delay between requests (seconds)\")\n\n    args = parser.parse_args()\n\n    success, errors = send_batch(\n        csv_path=args.csv,\n        campaign_id=args.campaign_id,\n        creative_id=args.creative_id,\n        delay=args.delay\n    )\n\n    print(f\"\\nCompleted: {success} sent, {errors} errors\")\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n### Test API Connection\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Test Poplar API connection and list campaigns.\"\"\"\n\nimport os\nimport requests\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef test_connection():\n    \"\"\"Test API connection and list available campaigns.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        print(\"Error: POPLAR_API_TOKEN environment variable not set\")\n        return False\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Accept\": \"application\u002Fjson\"\n    }\n\n    # Test authentication\n    print(\"Testing API connection...\")\n    try:\n        response = requests.get(f\"{POPLAR_API_URL}\u002Fme\", headers=headers)\n        response.raise_for_status()\n        org = response.json()\n        print(f\"Connected to organization: {org.get('name', 'Unknown')}\")\n    except requests.exceptions.RequestException as e:\n        print(f\"Authentication failed: {e}\")\n        return False\n\n    # List campaigns\n    print(\"\\nAvailable campaigns:\")\n    try:\n        response = requests.get(f\"{POPLAR_API_URL}\u002Fcampaigns\", headers=headers)\n        response.raise_for_status()\n        campaigns = response.json()\n\n        if not campaigns:\n            print(\"  No campaigns found\")\n        else:\n            for campaign in campaigns:\n                print(f\"  - {campaign.get('name', 'Unnamed')}: {campaign.get('id')}\")\n    except requests.exceptions.RequestException as e:\n        print(f\"Failed to list campaigns: {e}\")\n        return False\n\n    return True\n\n\nif __name__ == \"__main__\":\n    test_connection()\n```\n\n## Design Best Practices\n\n### Visual Design\n\n- **Less is more**: Avoid cluttering with excessive information\n- **High contrast**: Use contrasting colors for text visibility\n- **Large fonts**: Minimum 10pt for body text, 24pt+ for headlines\n- **Quality images**: Always use 300 PPI\u002FDPI resolution\n- **Edge-to-edge design**: Extend backgrounds to bleed area\n\n### Messaging\n\n- **Single clear CTA**: One primary call-to-action per piece\n- **Prominent offers**: Display promotions on both front and back\n- **Short URLs**: Use simplified URLs (brand.com\u002Fsave20)\n- **Social proof**: Include testimonials when relevant\n- **Urgency**: Add expiration dates for time-sensitive offers\n\n### QR Codes\n\nQR code images must be pre-generated and provided as a URL in your merge tags. Poplar does not auto-generate QR codes.\n\n**Providing QR codes:**\n```python\nmerge_tags = {\n    \"promotion\": {\n        \"qr_url\": \"https:\u002F\u002Fapi.qrserver.com\u002Fv1\u002Fcreate-qr-code\u002F?size=200x200&data=https:\u002F\u002Fyoursite.com\u002Foffer123\"\n    }\n}\n```\n\nOr use services like:\n- [QR Code Generator API](https:\u002F\u002Fgoqr.me\u002Fapi\u002F)\n- [QRCode Monkey](https:\u002F\u002Fwww.qrcode-monkey.com\u002F)\n- Your own QR generation service\n\n**Design guidelines:**\n- **Minimum size**: 0.75\" x 0.75\" (larger for complex URLs)\n- **Quiet zone**: Leave white space around the code\n- **Test before printing**: Always verify QR codes work\n- **Use URL shorteners**: Shorter URLs = simpler QR codes\n- **Uppercase URLs**: ALL CAPS creates smaller, more readable codes\n\n### Address Block\n\n- **Auto-applied**: Poplar adds the address block automatically\n- **Design behind it**: Extend your background to cover the address area\n- **Don't include**: Never add your own address block to templates\n\n## Template Examples\n\n### 4x6 Postcard - Front (Promotional)\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Poppins:wght@400;600;800&display=swap\" rel=\"stylesheet\">\n  \u003Cstyle>\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Poppins', sans-serif;\n      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);\n      margin: 0;\n    }\n\n    .safe-zone {\n      position: absolute;\n      top: 0.25in;\n      left: 0.25in;\n      right: 0.25in;\n      bottom: 0.25in;\n    }\n\n    .logo {\n      position: absolute;\n      top: 0;\n      left: 0;\n      width: 1.5in;\n    }\n\n    .headline {\n      position: absolute;\n      top: 1in;\n      left: 0;\n      right: 0;\n      font-size: 32pt;\n      font-weight: 800;\n      color: white;\n      text-align: center;\n      text-shadow: 2px 2px 4px rgba(0,0,0,0.3);\n    }\n\n    .subhead {\n      position: absolute;\n      top: 1.8in;\n      left: 0;\n      right: 0;\n      font-size: 16pt;\n      color: rgba(255,255,255,0.9);\n      text-align: center;\n    }\n\n    .offer-badge {\n      position: absolute;\n      top: 2.5in;\n      left: 50%;\n      transform: translateX(-50%);\n      width: 2.5in;\n      height: 2.5in;\n      background: white;\n      border-radius: 50%;\n      display: flex;\n      flex-direction: column;\n      align-items: center;\n      justify-content: center;\n      box-shadow: 0 10px 30px rgba(0,0,0,0.3);\n    }\n\n    .offer-amount {\n      font-size: 48pt;\n      font-weight: 800;\n      color: #764ba2;\n      line-height: 1;\n    }\n\n    .offer-text {\n      font-size: 14pt;\n      color: #333;\n      text-transform: uppercase;\n      letter-spacing: 2px;\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"safe-zone\">\n    \u003Cimg src=\"https:\u002F\u002Fyour-domain.com\u002Flogo-white.svg\" class=\"logo\" alt=\"Logo\">\n    \u003Cdiv class=\"headline\">{{recipient.first_name | capitalize}}, You're Invited!\u003C\u002Fdiv>\n    \u003Cdiv class=\"subhead\">Exclusive offer just for you\u003C\u002Fdiv>\n    \u003Cdiv class=\"offer-badge\">\n      \u003Cdiv class=\"offer-amount\">25%\u003C\u002Fdiv>\n      \u003Cdiv class=\"offer-text\">Off Everything\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### 4x6 Postcard - Back (with QR Code)\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Poppins:wght@400;600&display=swap\" rel=\"stylesheet\">\n  \u003Cstyle>\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Poppins', sans-serif;\n      background: white;\n      margin: 0;\n    }\n\n    .content-area {\n      position: absolute;\n      top: 0.25in;\n      left: 0.25in;\n      width: 3.25in;\n      bottom: 0.25in;\n    }\n\n    .details {\n      position: absolute;\n      top: 0;\n      left: 0;\n      font-size: 11pt;\n      color: #333;\n      line-height: 1.6;\n    }\n\n    .promo-code-box {\n      position: absolute;\n      top: 1.5in;\n      left: 0;\n      background: #f8f8f8;\n      border: 2px dashed #764ba2;\n      padding: 0.15in 0.25in;\n      text-align: center;\n    }\n\n    .promo-label {\n      font-size: 10pt;\n      color: #666;\n      text-transform: uppercase;\n    }\n\n    .promo-code {\n      font-size: 18pt;\n      font-weight: 600;\n      color: #764ba2;\n      letter-spacing: 3px;\n    }\n\n    .expiry {\n      position: absolute;\n      top: 2.4in;\n      left: 0;\n      font-size: 9pt;\n      color: #999;\n    }\n\n    .qr-section {\n      position: absolute;\n      bottom: 0;\n      left: 0;\n    }\n\n    .qr-code {\n      width: 1in;\n      height: 1in;\n    }\n\n    .qr-text {\n      font-size: 9pt;\n      color: #666;\n      margin-top: 0.1in;\n    }\n\n    \u002F* Address block area - leave clear for Poplar *\u002F\n    .address-area {\n      position: absolute;\n      top: 0.375in;\n      right: 0.25in;\n      width: 2.625in;\n      height: 1.125in;\n      \u002F* This area will be covered by Poplar's address block *\u002F\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"content-area\">\n    \u003Cdiv class=\"details\">\n      Shop our entire collection with your\u003Cbr>\n      exclusive discount. Free shipping on\u003Cbr>\n      orders over $50!\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"promo-code-box\">\n      \u003Cdiv class=\"promo-label\">Your Code\u003C\u002Fdiv>\n      \u003Cdiv class=\"promo-code\">{{promotion.promo_code}}\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"expiry\">\n      Expires: {{ \"now\" | date: \"%s\" | plus: 2592000 | date: \"%B %e, %Y\" }}\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"qr-section\">\n      \u003Cimg src=\"{{promotion.qr_url}}\" class=\"qr-code\" alt=\"Scan to shop\">\n      \u003Cdiv class=\"qr-text\">Scan to shop now\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n## Troubleshooting\n\n### Template Issues\n\n**\"Unsupported unit\" error**\n- Use only `in` or `px` units, not `em`, `rem`, `vw`, `vh`, or `%`\n\n**Images not appearing**\n- Ensure all image URLs are absolute (full URLs starting with `https:\u002F\u002F`)\n- Verify URLs are publicly accessible (test in incognito browser)\n- Check file size is under 5MB\n\n**Fonts not rendering**\n- Use Google Fonts or self-hosted font files\n- Typekit and Adobe Fonts are not supported\n- Include all font weights you use in the `\u003Clink>` tag\n\n**Merge tags not replaced**\n- Check column headers in your data match merge tag names exactly\n- Verify Liquid syntax is correct (no typos)\n- Use `| default: \"fallback\"` for optional fields\n\n### API Issues\n\n**401 Unauthorized**\n- Verify your API token is correct\n- Check if using test token for non-mailing endpoints (test tokens only work for `\u002Fmailing`)\n\n**400 Bad Request**\n- Campaign must be active\n- Creative must be uploaded\n- Required recipient fields: `address_1`, `city`, `state`, `postal_code`\n\n**Campaign not active error**\n- Activate the campaign in the Poplar dashboard before sending\n\n### Preview Differences\n\n**Browser vs PDF preview differ**\n- Always check the PDF proof from Poplar, not browser preview\n- HTML-to-PDF conversion may render some CSS differently\n- Avoid CSS features not well-supported in PDF rendering\n\n## Resources\n\n- [Poplar Documentation](https:\u002F\u002Fdocs.heypoplar.com)\n- [API Reference](https:\u002F\u002Fdocs.heypoplar.com\u002Fapi)\n- [Template Downloads](https:\u002F\u002Fdocs.heypoplar.com\u002Fcreative-design\u002Ftemplates-and-specs)\n- [Creative Best Practices](https:\u002F\u002Fheypoplar.com\u002Farticles\u002Fcreative-best-practices)\n- [Support](mailto:support@heypoplar.com)\n","# Poplar Direct Mail\n\n## Overview\n\nDesign professional direct mail creative using Poplar's HTML template system and send programmatic mail pieces via their API. This skill covers template creation with dynamic personalization, API integration for triggered mailings, and creative best practices for high-converting direct mail campaigns.\n\n## When to Use\n\n- Creating HTML templates for direct mail postcards, bi-folds, tri-folds, or letters\n- Building triggered\u002Fprogrammatic direct mail campaigns\n- Integrating direct mail into marketing automation workflows\n- Designing personalized mail pieces with dynamic content (names, offers, QR codes)\n- Sending transactional mail (receipts, confirmations, statements)\n- Setting up abandoned cart or win-back mail campaigns\n\n## Prerequisites\n\n- Poplar account ([heypoplar.com](https:\u002F\u002Fheypoplar.com))\n- API access token from [Poplar Credentials](https:\u002F\u002Fapp.heypoplar.com\u002Fcredentials)\n- Python 3.9+ (for scripts)\n- `requests` package\n\n## Installation\n\n```bash\npip install requests\n```\n\nSet your API token:\n\n```bash\n# Test token (for development - only works with mailing endpoint)\nexport POPLAR_API_TOKEN=\"test_your_token_here\"\n\n# Production token (for live mailings)\nexport POPLAR_API_TOKEN=\"your_production_token_here\"\n```\n\n## Mail Formats & Dimensions\n\n### Postcards\n\n| Size | Final Trim | With Bleed | Pixels (300 PPI) |\n|------|------------|------------|------------------|\n| 4\" x 6\" | 4\" x 6\" | 4.25\" x 6.25\" | 1275 x 1875 |\n| 6\" x 9\" | 6\" x 9\" | 6.25\" x 9.25\" | 1875 x 2775 |\n| 6\" x 11\" | 6\" x 11\" | 6.25\" x 11.25\" | 1875 x 3375 |\n\n**Best for:** Retargeting, time-sensitive promotions, simple messaging, direct mail newcomers\n\n### Bi-folds\n\n| Format | Pixels (300 PPI) |\n|--------|------------------|\n| Short-fold (folds left to right) | 1725 x 5175 |\n| Long-fold (folds top to bottom) | 3375 x 2625 |\n\n**Best for:** Prospecting campaigns, new product launches, complex value propositions\n\n### Tri-folds\n\n| Format | Pixels (300 PPI) |\n|--------|------------------|\n| Standard Tri-fold | 2625 x 4987 |\n\n**Best for:** Multiple product selections, detailed information, catalogs\n\n### Letters\n\n| Format | Dimensions |\n|--------|------------|\n| 8.5\" x 11\" (Color or B&W) | 612 x 792 px (no bleed required) |\n\n**Best for:** Financial\u002Finsurance, sensitive content, transactional mailings, professional communications\n\n## HTML Template Structure\n\n### Basic Template\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Open+Sans:wght@400;600;700&display=swap\"\n        rel=\"stylesheet\" type=\"text\u002Fcss\">\n  \u003Cstyle>\n    * {\n      margin: 0;\n      padding: 0;\n      box-sizing: border-box;\n    }\n\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Open Sans', sans-serif;\n    }\n\n    .background {\n      position: absolute;\n      width: 100%;\n      height: 100%;\n      background-image: url('https:\u002F\u002Fyour-hosted-image.com\u002Fbackground.png');\n      background-size: cover;\n    }\n\n    .headline {\n      position: absolute;\n      top: 0.5in;\n      left: 0.375in;\n      font-size: 28pt;\n      font-weight: 700;\n      color: #1a1a1a;\n    }\n\n    .personalized-text {\n      position: absolute;\n      top: 1.2in;\n      left: 0.375in;\n      font-size: 14pt;\n      color: #333333;\n    }\n\n    .offer-box {\n      position: absolute;\n      bottom: 1in;\n      left: 0.375in;\n      width: 3.5in;\n      padding: 0.25in;\n      background-color: #ff6b35;\n      color: white;\n      text-align: center;\n      font-size: 18pt;\n      font-weight: 600;\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"background\">\u003C\u002Fdiv>\n  \u003Cdiv class=\"headline\">Special Offer Inside!\u003C\u002Fdiv>\n  \u003Cdiv class=\"personalized-text\">\n    Hi {{recipient.first_name | default: \"Friend\"}},\n  \u003C\u002Fdiv>\n  \u003Cdiv class=\"offer-box\">\n    Use code: {{promotion.promo_code}}\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### CSS Requirements\n\n| Requirement | Details |\n|-------------|---------|\n| CSS Location | All styles in `\u003Cstyle>` tag within `\u003Chead>` |\n| Positioning | Use `position: absolute` for all elements |\n| Units | Only `in` (inches) or `px` (pixels) - no `em`, `rem`, `vw`, `vh` |\n| Image URLs | Absolute URLs only (must be publicly accessible) |\n| Fonts | Google Fonts or self-hosted `.ttf`\u002F`.woff` files |\n\n### Font Implementation\n\n**Google Fonts (recommended):**\n\n```html\n\u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Montserrat:wght@400;600;700&display=swap\"\n      rel=\"stylesheet\" type=\"text\u002Fcss\">\n```\n\n**Custom fonts:**\n\n```css\n@font-face {\n  font-family: \"CustomFont\";\n  src: url(\"https:\u002F\u002Fyour-domain.com\u002Ffonts\u002FCustomFont.ttf\") format(\"truetype\");\n}\n```\n\n## Merge Tags & Personalization\n\n### Recipient Data\n\n```liquid\n{{recipient.first_name}}      \u003C!-- First name or \"Current Resident\" -->\n{{recipient.last_name}}       \u003C!-- Last name -->\n{{recipient.full_name}}       \u003C!-- Full name -->\n{{recipient.address_1}}       \u003C!-- Street address -->\n{{recipient.city}}            \u003C!-- City -->\n{{recipient.state}}           \u003C!-- State -->\n{{recipient.postal_code}}     \u003C!-- ZIP code -->\n```\n\n### Promotion Codes\n\n```liquid\n{{promotion.promo_code}}      \u003C!-- Unique promo code -->\n{{promotion.qr_url}}          \u003C!-- URL for QR code generation -->\n```\n\n### Location-Based\n\n```liquid\n{{location.city}}             \u003C!-- Recipient's city -->\n{{location.state}}            \u003C!-- Recipient's state -->\n{{location.store_address}}    \u003C!-- Nearest store address -->\n```\n\n### Custom Data\n\n```liquid\n{{custom.purchase_amount}}    \u003C!-- Custom field from your data -->\n{{custom.product_name}}       \u003C!-- Product purchased -->\n{{custom.loyalty_tier}}       \u003C!-- Customer tier -->\n```\n\n## Liquid Template Logic\n\n### Conditional Content\n\n```liquid\n{% if recipient.first_name %}\n  Hi {{recipient.first_name | capitalize}},\n{% else %}\n  Dear Valued Customer,\n{% endif %}\n```\n\n### Offer Tiers Based on Purchase History\n\n```liquid\n{% if custom.lifetime_value >= 500 %}\n  \u003Cdiv class=\"offer\">Enjoy 25% off your next order!\u003C\u002Fdiv>\n{% elsif custom.lifetime_value >= 200 %}\n  \u003Cdiv class=\"offer\">Take 15% off your next purchase!\u003C\u002Fdiv>\n{% else %}\n  \u003Cdiv class=\"offer\">Get $10 off orders over $50!\u003C\u002Fdiv>\n{% endif %}\n```\n\n### Rolling Expiration Dates\n\n```liquid\n\u003C!-- 30 days from print date -->\nExpires: {{ \"now\" | date: \"%s\" | plus: 2592000 | date: \"%B %e, %Y\" }}\n\n\u003C!-- 90 days from print date -->\nExpires: {{ \"now\" | date: \"%s\" | plus: 7776000 | date: \"%B %e, %Y\" }}\n```\n\n### Text Formatting Filters\n\n```liquid\n{{ recipient.first_name | capitalize }}     \u003C!-- Capitalizes first letter -->\n{{ recipient.first_name | upcase }}         \u003C!-- ALL CAPS -->\n{{ recipient.first_name | downcase }}       \u003C!-- all lowercase -->\n{{ custom.price | money }}                  \u003C!-- Format as currency -->\n```\n\n## API Reference\n\n### Authentication\n\nAll requests require a Bearer token:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_TOKEN\" \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fme\n```\n\n### Create Mailing\n\n**Endpoint:** `POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing`\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"campaign_id\": \"your-campaign-id\",\n    \"creative_id\": \"your-creative-id\",\n    \"recipient\": {\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Smith\",\n      \"address_1\": \"123 Main Street\",\n      \"address_2\": \"Apt 4B\",\n      \"city\": \"San Francisco\",\n      \"state\": \"CA\",\n      \"postal_code\": \"94102\"\n    },\n    \"merge_tags\": {\n      \"promo_code\": \"SAVE20\",\n      \"expiration_date\": \"December 31, 2024\"\n    }\n  }'\n```\n\n**Response (201 Created):**\n\n```json\n{\n  \"id\": \"mailing-uuid\",\n  \"campaign_id\": \"campaign-uuid\",\n  \"creative_id\": \"creative-uuid\",\n  \"state\": \"processing\",\n  \"front_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Ffront.png\",\n  \"back_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Fback.png\",\n  \"pdf_url\": \"https:\u002F\u002Fapp.heypoplar.com\u002Fpreview\u002Fproof.pdf\",\n  \"total_cost\": \"0.89\",\n  \"created_at\": \"2024-01-15T10:30:00Z\"\n}\n```\n\n### Schedule Future Mailing\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"campaign_id\": \"your-campaign-id\",\n    \"recipient\": {\n      \"full_name\": \"John Doe\",\n      \"address_1\": \"456 Oak Avenue\",\n      \"city\": \"Austin\",\n      \"state\": \"TX\",\n      \"postal_code\": \"78701\"\n    },\n    \"send_at\": \"2024-02-01T09:00:00Z\"\n  }'\n```\n\n### Get Mailing Status\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing\u002F:id`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fmailing\u002FMAILING_ID \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### List Campaigns\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaigns`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaigns \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### List Campaign Creatives\n\n**Endpoint:** `GET https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaign\u002F:id\u002Fcreatives`\n\n```bash\ncurl https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fcampaign\u002FCAMPAIGN_ID\u002Fcreatives \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n```\n\n### Add to Do Not Mail List\n\n**Endpoint:** `POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fdo-not-mail`\n\n```bash\ncurl -X POST https:\u002F\u002Fapi.heypoplar.com\u002Fv1\u002Fdo-not-mail \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"email\": \"customer@example.com\",\n    \"address\": {\n      \"address_1\": \"123 Main St\",\n      \"postal_code\": \"94102\"\n    }\n  }'\n```\n\n## Python Scripts\n\n### Send Single Mailing\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Send a single direct mail piece via Poplar API.\"\"\"\n\nimport os\nimport requests\nimport argparse\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef send_mailing(\n    campaign_id: str,\n    recipient: dict,\n    creative_id: str = None,\n    merge_tags: dict = None,\n    send_at: str = None\n) -> dict:\n    \"\"\"Send a mailing via Poplar API.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        raise ValueError(\"POPLAR_API_TOKEN environment variable not set\")\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Content-Type\": \"application\u002Fjson\"\n    }\n\n    payload = {\n        \"campaign_id\": campaign_id,\n        \"recipient\": recipient\n    }\n\n    if creative_id:\n        payload[\"creative_id\"] = creative_id\n    if merge_tags:\n        payload[\"merge_tags\"] = merge_tags\n    if send_at:\n        payload[\"send_at\"] = send_at\n\n    response = requests.post(\n        f\"{POPLAR_API_URL}\u002Fmailing\",\n        headers=headers,\n        json=payload\n    )\n    response.raise_for_status()\n    return response.json()\n\n\ndef main():\n    parser = argparse.ArgumentParser(description=\"Send a Poplar direct mail piece\")\n    parser.add_argument(\"--campaign-id\", required=True, help=\"Campaign ID\")\n    parser.add_argument(\"--creative-id\", help=\"Creative ID (optional)\")\n    parser.add_argument(\"--first-name\", required=True, help=\"Recipient first name\")\n    parser.add_argument(\"--last-name\", required=True, help=\"Recipient last name\")\n    parser.add_argument(\"--address\", required=True, help=\"Street address\")\n    parser.add_argument(\"--city\", required=True, help=\"City\")\n    parser.add_argument(\"--state\", required=True, help=\"State (2-letter code)\")\n    parser.add_argument(\"--zip\", required=True, help=\"ZIP code\")\n    parser.add_argument(\"--promo-code\", help=\"Promo code merge tag\")\n\n    args = parser.parse_args()\n\n    recipient = {\n        \"first_name\": args.first_name,\n        \"last_name\": args.last_name,\n        \"address_1\": args.address,\n        \"city\": args.city,\n        \"state\": args.state,\n        \"postal_code\": args.zip\n    }\n\n    merge_tags = {}\n    if args.promo_code:\n        merge_tags[\"promo_code\"] = args.promo_code\n\n    result = send_mailing(\n        campaign_id=args.campaign_id,\n        recipient=recipient,\n        creative_id=args.creative_id,\n        merge_tags=merge_tags if merge_tags else None\n    )\n\n    print(f\"Mailing created: {result['id']}\")\n    print(f\"Status: {result['state']}\")\n    print(f\"Cost: ${result['total_cost']}\")\n    print(f\"PDF Preview: {result['pdf_url']}\")\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n### Batch Send from CSV\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Send batch mailings from a CSV file.\"\"\"\n\nimport os\nimport csv\nimport time\nimport requests\nimport argparse\nfrom typing import Generator\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef read_recipients(csv_path: str) -> Generator[dict, None, None]:\n    \"\"\"Read recipients from CSV file.\"\"\"\n    with open(csv_path, 'r') as f:\n        reader = csv.DictReader(f)\n        for row in reader:\n            yield {\n                \"recipient\": {\n                    \"first_name\": row.get(\"first_name\", \"\"),\n                    \"last_name\": row.get(\"last_name\", \"\"),\n                    \"address_1\": row.get(\"address_1\", \"\"),\n                    \"address_2\": row.get(\"address_2\", \"\"),\n                    \"city\": row.get(\"city\", \"\"),\n                    \"state\": row.get(\"state\", \"\"),\n                    \"postal_code\": row.get(\"postal_code\", \"\")\n                },\n                \"merge_tags\": {\n                    k: v for k, v in row.items()\n                    if k not in [\"first_name\", \"last_name\", \"address_1\",\n                                 \"address_2\", \"city\", \"state\", \"postal_code\"]\n                }\n            }\n\n\ndef send_batch(\n    csv_path: str,\n    campaign_id: str,\n    creative_id: str = None,\n    delay: float = 0.1\n) -> tuple[int, int]:\n    \"\"\"Send batch mailings from CSV.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        raise ValueError(\"POPLAR_API_TOKEN environment variable not set\")\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Content-Type\": \"application\u002Fjson\"\n    }\n\n    success_count = 0\n    error_count = 0\n\n    for record in read_recipients(csv_path):\n        payload = {\n            \"campaign_id\": campaign_id,\n            \"recipient\": record[\"recipient\"]\n        }\n\n        if creative_id:\n            payload[\"creative_id\"] = creative_id\n        if record[\"merge_tags\"]:\n            payload[\"merge_tags\"] = record[\"merge_tags\"]\n\n        try:\n            response = requests.post(\n                f\"{POPLAR_API_URL}\u002Fmailing\",\n                headers=headers,\n                json=payload\n            )\n            response.raise_for_status()\n            success_count += 1\n            print(f\"Sent to {record['recipient']['first_name']} {record['recipient']['last_name']}\")\n        except requests.exceptions.RequestException as e:\n            error_count += 1\n            print(f\"Error sending to {record['recipient']}: {e}\")\n\n        time.sleep(delay)\n\n    return success_count, error_count\n\n\ndef main():\n    parser = argparse.ArgumentParser(description=\"Send batch Poplar mailings from CSV\")\n    parser.add_argument(\"--csv\", required=True, help=\"Path to CSV file\")\n    parser.add_argument(\"--campaign-id\", required=True, help=\"Campaign ID\")\n    parser.add_argument(\"--creative-id\", help=\"Creative ID (optional)\")\n    parser.add_argument(\"--delay\", type=float, default=0.1, help=\"Delay between requests (seconds)\")\n\n    args = parser.parse_args()\n\n    success, errors = send_batch(\n        csv_path=args.csv,\n        campaign_id=args.campaign_id,\n        creative_id=args.creative_id,\n        delay=args.delay\n    )\n\n    print(f\"\\nCompleted: {success} sent, {errors} errors\")\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n### Test API Connection\n\n```python\n#!\u002Fusr\u002Fbin\u002Fenv python3\n\"\"\"Test Poplar API connection and list campaigns.\"\"\"\n\nimport os\nimport requests\n\nPOPLAR_API_URL = \"https:\u002F\u002Fapi.heypoplar.com\u002Fv1\"\n\ndef test_connection():\n    \"\"\"Test API connection and list available campaigns.\"\"\"\n    token = os.environ.get(\"POPLAR_API_TOKEN\")\n    if not token:\n        print(\"Error: POPLAR_API_TOKEN environment variable not set\")\n        return False\n\n    headers = {\n        \"Authorization\": f\"Bearer {token}\",\n        \"Accept\": \"application\u002Fjson\"\n    }\n\n    # Test authentication\n    print(\"Testing API connection...\")\n    try:\n        response = requests.get(f\"{POPLAR_API_URL}\u002Fme\", headers=headers)\n        response.raise_for_status()\n        org = response.json()\n        print(f\"Connected to organization: {org.get('name', 'Unknown')}\")\n    except requests.exceptions.RequestException as e:\n        print(f\"Authentication failed: {e}\")\n        return False\n\n    # List campaigns\n    print(\"\\nAvailable campaigns:\")\n    try:\n        response = requests.get(f\"{POPLAR_API_URL}\u002Fcampaigns\", headers=headers)\n        response.raise_for_status()\n        campaigns = response.json()\n\n        if not campaigns:\n            print(\"  No campaigns found\")\n        else:\n            for campaign in campaigns:\n                print(f\"  - {campaign.get('name', 'Unnamed')}: {campaign.get('id')}\")\n    except requests.exceptions.RequestException as e:\n        print(f\"Failed to list campaigns: {e}\")\n        return False\n\n    return True\n\n\nif __name__ == \"__main__\":\n    test_connection()\n```\n\n## Design Best Practices\n\n### Visual Design\n\n- **Less is more**: Avoid cluttering with excessive information\n- **High contrast**: Use contrasting colors for text visibility\n- **Large fonts**: Minimum 10pt for body text, 24pt+ for headlines\n- **Quality images**: Always use 300 PPI\u002FDPI resolution\n- **Edge-to-edge design**: Extend backgrounds to bleed area\n\n### Messaging\n\n- **Single clear CTA**: One primary call-to-action per piece\n- **Prominent offers**: Display promotions on both front and back\n- **Short URLs**: Use simplified URLs (brand.com\u002Fsave20)\n- **Social proof**: Include testimonials when relevant\n- **Urgency**: Add expiration dates for time-sensitive offers\n\n### QR Codes\n\nQR code images must be pre-generated and provided as a URL in your merge tags. Poplar does not auto-generate QR codes.\n\n**Providing QR codes:**\n```python\nmerge_tags = {\n    \"promotion\": {\n        \"qr_url\": \"https:\u002F\u002Fapi.qrserver.com\u002Fv1\u002Fcreate-qr-code\u002F?size=200x200&data=https:\u002F\u002Fyoursite.com\u002Foffer123\"\n    }\n}\n```\n\nOr use services like:\n- [QR Code Generator API](https:\u002F\u002Fgoqr.me\u002Fapi\u002F)\n- [QRCode Monkey](https:\u002F\u002Fwww.qrcode-monkey.com\u002F)\n- Your own QR generation service\n\n**Design guidelines:**\n- **Minimum size**: 0.75\" x 0.75\" (larger for complex URLs)\n- **Quiet zone**: Leave white space around the code\n- **Test before printing**: Always verify QR codes work\n- **Use URL shorteners**: Shorter URLs = simpler QR codes\n- **Uppercase URLs**: ALL CAPS creates smaller, more readable codes\n\n### Address Block\n\n- **Auto-applied**: Poplar adds the address block automatically\n- **Design behind it**: Extend your background to cover the address area\n- **Don't include**: Never add your own address block to templates\n\n## Template Examples\n\n### 4x6 Postcard - Front (Promotional)\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Poppins:wght@400;600;800&display=swap\" rel=\"stylesheet\">\n  \u003Cstyle>\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Poppins', sans-serif;\n      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);\n      margin: 0;\n    }\n\n    .safe-zone {\n      position: absolute;\n      top: 0.25in;\n      left: 0.25in;\n      right: 0.25in;\n      bottom: 0.25in;\n    }\n\n    .logo {\n      position: absolute;\n      top: 0;\n      left: 0;\n      width: 1.5in;\n    }\n\n    .headline {\n      position: absolute;\n      top: 1in;\n      left: 0;\n      right: 0;\n      font-size: 32pt;\n      font-weight: 800;\n      color: white;\n      text-align: center;\n      text-shadow: 2px 2px 4px rgba(0,0,0,0.3);\n    }\n\n    .subhead {\n      position: absolute;\n      top: 1.8in;\n      left: 0;\n      right: 0;\n      font-size: 16pt;\n      color: rgba(255,255,255,0.9);\n      text-align: center;\n    }\n\n    .offer-badge {\n      position: absolute;\n      top: 2.5in;\n      left: 50%;\n      transform: translateX(-50%);\n      width: 2.5in;\n      height: 2.5in;\n      background: white;\n      border-radius: 50%;\n      display: flex;\n      flex-direction: column;\n      align-items: center;\n      justify-content: center;\n      box-shadow: 0 10px 30px rgba(0,0,0,0.3);\n    }\n\n    .offer-amount {\n      font-size: 48pt;\n      font-weight: 800;\n      color: #764ba2;\n      line-height: 1;\n    }\n\n    .offer-text {\n      font-size: 14pt;\n      color: #333;\n      text-transform: uppercase;\n      letter-spacing: 2px;\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"safe-zone\">\n    \u003Cimg src=\"https:\u002F\u002Fyour-domain.com\u002Flogo-white.svg\" class=\"logo\" alt=\"Logo\">\n    \u003Cdiv class=\"headline\">{{recipient.first_name | capitalize}}, You're Invited!\u003C\u002Fdiv>\n    \u003Cdiv class=\"subhead\">Exclusive offer just for you\u003C\u002Fdiv>\n    \u003Cdiv class=\"offer-badge\">\n      \u003Cdiv class=\"offer-amount\">25%\u003C\u002Fdiv>\n      \u003Cdiv class=\"offer-text\">Off Everything\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n### 4x6 Postcard - Back (with QR Code)\n\n```html\n\u003C!DOCTYPE html>\n\u003Chtml>\n\u003Chead>\n  \u003Cmeta charset=\"UTF-8\">\n  \u003Clink href=\"https:\u002F\u002Ffonts.googleapis.com\u002Fcss2?family=Poppins:wght@400;600&display=swap\" rel=\"stylesheet\">\n  \u003Cstyle>\n    body {\n      width: 4.25in;\n      height: 6.25in;\n      position: relative;\n      font-family: 'Poppins', sans-serif;\n      background: white;\n      margin: 0;\n    }\n\n    .content-area {\n      position: absolute;\n      top: 0.25in;\n      left: 0.25in;\n      width: 3.25in;\n      bottom: 0.25in;\n    }\n\n    .details {\n      position: absolute;\n      top: 0;\n      left: 0;\n      font-size: 11pt;\n      color: #333;\n      line-height: 1.6;\n    }\n\n    .promo-code-box {\n      position: absolute;\n      top: 1.5in;\n      left: 0;\n      background: #f8f8f8;\n      border: 2px dashed #764ba2;\n      padding: 0.15in 0.25in;\n      text-align: center;\n    }\n\n    .promo-label {\n      font-size: 10pt;\n      color: #666;\n      text-transform: uppercase;\n    }\n\n    .promo-code {\n      font-size: 18pt;\n      font-weight: 600;\n      color: #764ba2;\n      letter-spacing: 3px;\n    }\n\n    .expiry {\n      position: absolute;\n      top: 2.4in;\n      left: 0;\n      font-size: 9pt;\n      color: #999;\n    }\n\n    .qr-section {\n      position: absolute;\n      bottom: 0;\n      left: 0;\n    }\n\n    .qr-code {\n      width: 1in;\n      height: 1in;\n    }\n\n    .qr-text {\n      font-size: 9pt;\n      color: #666;\n      margin-top: 0.1in;\n    }\n\n    \u002F* Address block area - leave clear for Poplar *\u002F\n    .address-area {\n      position: absolute;\n      top: 0.375in;\n      right: 0.25in;\n      width: 2.625in;\n      height: 1.125in;\n      \u002F* This area will be covered by Poplar's address block *\u002F\n    }\n  \u003C\u002Fstyle>\n\u003C\u002Fhead>\n\u003Cbody>\n  \u003Cdiv class=\"content-area\">\n    \u003Cdiv class=\"details\">\n      Shop our entire collection with your\u003Cbr>\n      exclusive discount. Free shipping on\u003Cbr>\n      orders over $50!\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"promo-code-box\">\n      \u003Cdiv class=\"promo-label\">Your Code\u003C\u002Fdiv>\n      \u003Cdiv class=\"promo-code\">{{promotion.promo_code}}\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"expiry\">\n      Expires: {{ \"now\" | date: \"%s\" | plus: 2592000 | date: \"%B %e, %Y\" }}\n    \u003C\u002Fdiv>\n\n    \u003Cdiv class=\"qr-section\">\n      \u003Cimg src=\"{{promotion.qr_url}}\" class=\"qr-code\" alt=\"Scan to shop\">\n      \u003Cdiv class=\"qr-text\">Scan to shop now\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fdiv>\n\u003C\u002Fbody>\n\u003C\u002Fhtml>\n```\n\n## Troubleshooting\n\n### Template Issues\n\n**\"Unsupported unit\" error**\n- Use only `in` or `px` units, not `em`, `rem`, `vw`, `vh`, or `%`\n\n**Images not appearing**\n- Ensure all image URLs are absolute (full URLs starting with `https:\u002F\u002F`)\n- Verify URLs are publicly accessible (test in incognito browser)\n- Check file size is under 5MB\n\n**Fonts not rendering**\n- Use Google Fonts or self-hosted font files\n- Typekit and Adobe Fonts are not supported\n- Include all font weights you use in the `\u003Clink>` tag\n\n**Merge tags not replaced**\n- Check column headers in your data match merge tag names exactly\n- Verify Liquid syntax is correct (no typos)\n- Use `| default: \"fallback\"` for optional fields\n\n### API Issues\n\n**401 Unauthorized**\n- Verify your API token is correct\n- Check if using test token for non-mailing endpoints (test tokens only work for `\u002Fmailing`)\n\n**400 Bad Request**\n- Campaign must be active\n- Creative must be uploaded\n- Required recipient fields: `address_1`, `city`, `state`, `postal_code`\n\n**Campaign not active error**\n- Activate the campaign in the Poplar dashboard before sending\n\n### Preview Differences\n\n**Browser vs PDF preview differ**\n- Always check the PDF proof from Poplar, not browser preview\n- HTML-to-PDF conversion may render some CSS differently\n- Avoid CSS features not well-supported in PDF rendering\n\n## Resources\n\n- [Poplar Documentation](https:\u002F\u002Fdocs.heypoplar.com)\n- [API Reference](https:\u002F\u002Fdocs.heypoplar.com\u002Fapi)\n- [Template Downloads](https:\u002F\u002Fdocs.heypoplar.com\u002Fcreative-design\u002Ftemplates-and-specs)\n- [Creative Best Practices](https:\u002F\u002Fheypoplar.com\u002Farticles\u002Fcreative-best-practices)\n- [Support](mailto:support@heypoplar.com)\n",{"name":5,"description":7},"main","351d6f0a5dac78be33208c688fdbb820b9053685",".claude\u002Fskills\u002Fpoplar-direct-mail",0,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing","https:\u002F\u002Fgithub.com\u002Fsurfingalien","2026-11-14 00:29:40",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add surfingalien\u002FFinSurfing --skill poplar-direct-mail",{"tool":36,"command":37},"bunx","bunx skills add surfingalien\u002FFinSurfing --skill poplar-direct-mail",{"tool":39,"command":40},"pnpm","pnpm dlx skills add surfingalien\u002FFinSurfing --skill poplar-direct-mail","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002FSKILL.md",true,[44,50,54,58,64],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"scripts\u002Fsend_batch.py","SCRIPT","脚本",9507,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002Fscripts\u002Fsend_batch.py",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"scripts\u002Fsend_mailing.py",6534,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002Fscripts\u002Fsend_mailing.py",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"scripts\u002Ftest_connection.py",6915,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002Fscripts\u002Ftest_connection.py",{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"templates\u002Fpostcard-4x6-back.html","REFERENCE","参考文档",4283,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002Ftemplates\u002Fpostcard-4x6-back.html",{"path":65,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":66,"sourceHtmlUrl":67},"templates\u002Fpostcard-4x6-front.html",3252,"https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fpoplar-direct-mail\u002Ftemplates\u002Fpostcard-4x6-front.html",[69,75,81,88,95,102],{"skillNo":70,"name":71,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7490VYNX3NCT8R0PPSYHTXP","portfolio-management","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-management\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7490SNSG32QP06X1P1EVK7N","financial-analysis","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fskills\u002Ffinancial-analysis\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7490MKJ5QCVWWXC8HK57EVQ","tradingview-mcp","AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, Reddit sentiment, news, and multi-market screener. Supports stocks, crypto, ETFs, indices, Turkish (BIST), and Egyptian (EGX) markets.","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fopenclaw\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7490FHXRPVEPQMZ4KHFD161","sales-engineer","Analyzes RFP\u002FRFI responses for coverage gaps, builds competitive feature comparison matrices, and plans proof-of-concept (POC) engagements for pre-sales engineering. Use when responding to RFPs, bids, or proposal requests; comparing product features against competitors; planning or scoring a customer POC or sales demo; preparing a technical proposal; or performing win\u002Floss competitor analysis. Handles tasks described as 'RFP response', 'bid response', 'proposal response', 'competitor comparison', 'feature matrix', 'POC planning', 'sales demo prep', or 'pre-sales engineering'.","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fbusiness-growth\u002Fskills\u002Fsales-engineer\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7490C91D8F7CM7AXFZK8SQE","revenue-operations","Analyzes sales pipeline health, revenue forecasting accuracy, and go-to-market efficiency metrics for SaaS revenue optimization. Use when analyzing sales pipeline coverage, forecasting revenue, evaluating go-to-market performance, reviewing sales metrics, assessing pipeline analysis, tracking forecast accuracy with MAPE, calculating GTM efficiency, or measuring sales efficiency and unit economics for SaaS teams.","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fbusiness-growth\u002Fskills\u002Frevenue-operations\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M74907FEV2YRKSYPNG649HGF","customer-success-manager","Monitors customer health, predicts churn risk, and identifies expansion opportunities using weighted scoring models for SaaS customer success. Use when analyzing customer accounts, reviewing retention metrics, scoring at-risk customers, or when the user mentions churn, customer health scores, upsell opportunities, expansion revenue, retention analysis, or customer analytics. Runs three Python CLI tools to produce deterministic health scores, churn risk tiers, and prioritized expansion recommendations across Enterprise, Mid-Market, and SMB segments.","https:\u002F\u002Fgithub.com\u002Fsurfingalien\u002FFinSurfing\u002Fblob\u002Fmain\u002Fbusiness-growth\u002Fskills\u002Fcustomer-success-manager\u002FSKILL.md",[],[]]