Send A Custom Greeting Card

Send a Custom Greeting Card

Freshness

Last updated: 2026-06-24.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Mail custom folded greeting cards to any US address. You control all four panels: front cover (image), inside left, inside right (main message), and back — each panel can be text or image. Cards can be printed in horizontal or vertical orientation. Four font styles for text: handwritten (blue), elegant (charcoal), modern (near-black), classic (black). Printed on premium cardstock, folded, enveloped, and mailed via USPS First Class with tracking.

Product Instructions

Send a Custom Greeting Card

Mail custom folded greeting cards to any US address. Provide panel content (front cover image, inside text/images, back text/image) and the backend generates a print-ready PDF, prints it on premium 120# white uncoated cardstock, folds it, envelopes it, and mails it via USPS First Class.

Overview

This tool creates and mails physical folded greeting cards. There are two modes:

• Card Builder Mode (recommended): Provide individual panel content (front cover image, inside left/right text or images, back text or image) and the system assembles a print-ready 2-page PDF automatically.
• Raw PDF Mode: Provide your own pre-built 2-page PDF (must be exactly 2 pages, 5.5 x 8.5 inches flat).

The recommended workflow is: preview first, then send after user approval.

Panel Layout

PAGE 1 (outside)            PAGE 2 (inside)
+------------------+        +------------------+
|   BACK panel     |        |   INSIDE LEFT    |
|  (rotated 180)   |        |                  |
+------------------+        +------------------+
|   FRONT COVER    |        |   INSIDE RIGHT   |
|  (right-side up) |        |   (message area) |
+------------------+        +------------------+

• Front cover -- always an image (required in card builder mode). This is the card front when folded.
• Inside left -- text or image (optional). Visible when card is opened, left side.
• Inside right -- text or image (optional). The main message/greeting area.
• Back -- text or image (optional). Small branding, attribution, etc.

Each panel accepts text OR image (not both). Panels left empty render as blank white.

Physical Card Specs

• Flat sheet: 5.5 x 8.5 inches portrait (1650 x 2550 px at 300 DPI)
• Folded: 5.5 x 4.25 inches
• Paper: 120# White Uncoated premium cardstock
• Mailed in envelope with printed address via USPS First Class

Actions

render_preview

Generate a preview of the card without mailing. Returns the generated PDF (with signed URL) and preview images (front and inside JPGs with signed URLs) for the user to review before committing to send.

Required parameters (card builder mode -- at least one panel content field):

• front_cover_image_url (string) -- URL to front cover image (JPG/PNG). Required in card builder mode.
• OR front_cover_image_file_id (string) -- File ID of front cover image. Alternative to URL.

Required parameters (raw PDF mode -- exactly one of):

• document_pdf_url (string) -- Public URL to a print-ready 2-page PDF.
• document_pdf_file_id (string) -- File ID of a print-ready PDF in cloud storage.

Optional parameters (card builder mode):

• orientation (string, default: "horizontal") -- Card orientation. horizontal: landscape panels, card folds along top edge. vertical: portrait panels, card folds along left edge.
• font_style (string, default: "handwritten") -- Font style for text panels. Options: handwritten (Caveat, blue), elegant (Playfair Display, charcoal), modern (Montserrat, near-black), classic (Liberation Serif, black).
• inside_left_text (string) -- Text for inside left panel.
• inside_left_image_url (string) -- Image URL for inside left panel.
• inside_left_image_file_id (string) -- File ID for inside left image.
• inside_right_text (string) -- Text for inside right panel (main message area).
• inside_right_image_url (string) -- Image URL for inside right panel.
• inside_right_image_file_id (string) -- File ID for inside right image.
• back_text (string) -- Text for back of card.
• back_image_url (string) -- Image URL for back of card.
• back_image_file_id (string) -- File ID for back image.

Example: Preview with card builder

{
  "action": "render_preview",
  "front_cover_image_url": "https://example.com/front.jpg",
  "inside_right_text": "Happy Birthday!\n\nWishing you all the best.",
  "font_style": "handwritten"
}

Example: Preview with raw PDF

{
  "action": "render_preview",
  "document_pdf_url": "https://example.com/my-card.pdf"
}

create_proof

Upload the card to the print service and create the print job without mailing. This creates the job in the print system for final review. Requires a recipient address.

Required parameters:

• Card content: same as render_preview (card builder fields or raw PDF).
• recipient_address (object) -- Recipient mailing address (US only). Required fields within: address1, city, state (two-letter code), postal_code. Must also include name or organization (or both).

Optional parameters:

• All card builder options from render_preview (orientation, font_style, panel content fields).

Example: Create proof

{
  "action": "create_proof",
  "front_cover_image_file_id": "FILE_ID",
  "inside_right_text": "Thank you for your business!",
  "font_style": "elegant",
  "recipient_address": {
    "name": "Jane Doe",
    "address1": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701"
  }
}

send

Generate the card PDF, print it, and mail it to the recipient. Returns the order ID, document PDF (with signed URL), and preview images.

Required parameters:

• Card content: same as render_preview (card builder fields or raw PDF).
• recipient_address (object) -- Recipient mailing address (US only). Required fields within: address1, city, state (two-letter code), postal_code. Must also include name or organization (or both). Optional: address2, country (defaults to "US").

Optional parameters:

• All card builder options from render_preview (orientation, font_style, panel content fields).

Example: Send a greeting card (card builder)

{
  "action": "send",
  "front_cover_image_file_id": "FILE_ID",
  "inside_right_text": "Happy Birthday!\n\nWishing you all the best.",
  "back_text": "Made with love",
  "font_style": "elegant",
  "orientation": "horizontal",
  "recipient_address": {
    "name": "Jane Doe",
    "address1": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701"
  }
}

Example: Send with all panels filled

{
  "action": "send",
  "front_cover_image_url": "https://example.com/holiday-photo.jpg",
  "inside_left_image_url": "https://example.com/family-photo.jpg",
  "inside_right_text": "Season's Greetings!\n\nWishing you warmth and joy this holiday season.",
  "back_text": "From the Smith Family, 2026",
  "font_style": "classic",
  "recipient_address": {
    "name": "The Johnson Family",
    "address1": "789 Pine Rd",
    "city": "Denver",
    "state": "CO",
    "postal_code": "80202"
  }
}

get_order_status

Check the status of a previously sent or proofed card order. Automatically includes USPS tracking information when available.

Required parameters:

• order_id (string) -- Order ID returned from a previous send or create_proof call.

Example: Check order status

{
  "action": "get_order_status",
  "order_id": "ORDER_ID"
}

get_tracking

Get USPS tracking details for a previously sent card order.

Required parameters:

• order_id (string) -- Order ID returned from a previous send call.

Optional parameters:

• tracking_type (string) -- Tracking barcode type. Options: IMB (Intelligent Mail Barcode, default), IMPB (Intelligent Mail Package Barcode).

Example: Get tracking

{
  "action": "get_tracking",
  "order_id": "ORDER_ID"
}

Example: Get package tracking

{
  "action": "get_tracking",
  "order_id": "ORDER_ID",
  "tracking_type": "IMPB"
}

list_orders

List past greeting card orders for the current budget, sorted by most recent first.

Optional parameters:

• limit (integer, default: 10, min: 1, max: 50) -- Number of orders to return.

Example: List recent orders

{
  "action": "list_orders",
  "limit": 10
}

Workflows

Preview then send (recommended)

1. Call render_preview with the card content to generate a proof.
2. The response includes document_file (full PDF with signed URL) and preview_images (front and inside JPGs with signed URLs). Show these to the user for review.
3. Once the user approves, call send with the same card content plus recipient_address.

Create proof then approve

1. Call create_proof with card content and recipient address to create a print job without mailing.
2. Review the proof in the print system.
3. Use the order ID to check status with get_order_status.

Check delivery status

1. After sending, save the order_id from the response.
2. Call get_order_status with that order_id to check printing and mailing status.
3. Use get_tracking for detailed USPS tracking information.

Notes

• US addresses only. International mailing is not supported.
• Recipient must include name or organization (or both) in the address.
• Card builder mode and raw PDF mode are mutually exclusive. Use one or the other; providing both returns an error.
• Each panel is text OR image, not both. Providing both text and image for the same panel returns an error.
• Front cover image is required in card builder mode. It must be a direct link to a JPG or PNG image.
• For each image panel, provide either the URL or file ID, not both.
• Raw PDF must be exactly 2 pages. Page 1 is the outside (front cover + back), page 2 is the inside (left + right panels).
• Font auto-sizing: Text is automatically sized to fit within the panel (72px max, 18px min).
• Preview files expire after 7 days. The signed URLs for document PDFs and preview images are temporary.
• Text supports newlines. Use \n in text fields for line breaks.
• Images are cover-cropped to fill the panel exactly (no margins, no distortion).

When To Use

• Use this skill for Send a Custom Greeting Card on AgentPMT.
• Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
• Search and activation keywords: send a custom greeting card, send a greeting card, holiday greeting card campaigns, customer appreciation and thank you cards, birthday and anniversary greetings, event invitation mailings, create proof, orientation.
• Supported action names: create_proof, get_order_status, get_tracking, list_orders, render_preview, send.

Use Cases

• Holiday greeting card campaigns
• Customer appreciation and thank-you cards
• Birthday and anniversary greetings
• Event invitation mailings
• Nonprofit donor outreach cards
• Real estate follow-up mailers
• Employee recognition cards
• Brand loyalty and retention mailings
• Condolence and sympathy cards
• Welcome and onboarding cards

Related Product Skills

• File Storage - Over 10MB: ../file-storage-over-10mb (ClawHub: file-storage-over-10mb, page: https://clawhub.ai/agentpmt/file-storage-over-10mb; skills.sh: npx skills add AgentPMT/agent-skills --skill file-storage-over-10mb)
• File Management: ../file-management (ClawHub: file-management, page: https://clawhub.ai/agentpmt/file-management; skills.sh: npx skills add AgentPMT/agent-skills --skill file-management)
• File Storage - 10MB or less: ../file-storage-10mb-or-less (ClawHub: file-storage-10mb-or-less, page: https://clawhub.ai/agentpmt/file-storage-10mb-or-less; skills.sh: npx skills add AgentPMT/agent-skills --skill file-storage-10mb-or-less)

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 6. x402 availability: not enabled for this product.

• create_proof (action slug: create-proof): Upload the card to Click2Mail and create the print job without mailing. Used for final review before committing to send. Price: 400 credits. Parameters: back_image_file_id, back_image_url, back_text, document_pdf_file_id, document_pdf_url, font_style, front_cover_image_file_id, front_cover_image_url, plus 8 more.
• get_order_status (action slug: get-order-status): Check the status of a previously sent or proofed card order. Automatically includes USPS tracking information when available. Price: 400 credits. Parameters: order_id.
• get_tracking (action slug: get-tracking): Get USPS tracking details for a previously sent card order. Price: 400 credits. Parameters: order_id, tracking_type.
• list_orders (action slug: list-orders): List past greeting card orders for the current budget, sorted by most recent first. Price: 400 credits. Parameters: limit.
• render_preview (action slug: render-preview): Generate a preview of the greeting card without mailing. Returns the generated PDF and preview images with signed URLs for review before sending. Price: 400 credits. Parameters: back_image_file_id, back_image_url, back_text, document_pdf_file_id, document_pdf_url, font_style, front_cover_image_file_id, front_cover_image_url, plus 7 more.
• send (action slug: send): Generate the card PDF, print it on premium cardstock, fold it, envelope it, and mail it via USPS First Class to the recipient address. Price: 400 credits. Parameters: back_image_file_id, back_image_url, back_text, document_pdf_file_id, document_pdf_url, font_style, front_cover_image_file_id, front_cover_image_url, plus 8 more.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

• Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "send-a-greeting-card".
• Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "send-a-greeting-card", or call this product with action: "get_instructions" when the product tool is already selected.
• Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "send-a-greeting-card"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "send-a-greeting-card"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "send-a-greeting-card"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "send-a-greeting-card"
  }
}

Call This Tool

Product slug: send-a-greeting-card

Marketplace page: https://www.agentpmt.com/marketplace/send-a-greeting-card

• AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
• x402 route: not enabled for this product.
• AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

• What AgentPMT is: ../what-is-agentpmt
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "Send-a-Custom-Greeting-Card",
    "arguments": {
      "action": "create_proof",
      "back_image_file_id": "example back image file id",
      "back_image_url": "https://example.com",
      "back_text": "example back text",
      "document_pdf_file_id": "example document pdf file id",
      "document_pdf_url": "https://example.com",
      "font_style": "handwritten",
      "front_cover_image_file_id": "example front cover image file id",
      "front_cover_image_url": "https://example.com"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "send-a-greeting-card",
  "parameters": {
    "action": "create_proof",
    "back_image_file_id": "example back image file id",
    "back_image_url": "https://example.com",
    "back_text": "example back text",
    "document_pdf_file_id": "example document pdf file id",
    "document_pdf_url": "https://example.com",
    "font_style": "handwritten",
    "front_cover_image_file_id": "example front cover image file id",
    "front_cover_image_url": "https://example.com"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

• Treat the returned JSON as the source of truth for this tool call.
• If the response includes warnings or correction targets, apply them before retrying.
• If the response includes a passed or success-style boolean, use it as the workflow gate.
• If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
• If create_proof fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

• Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
• Keep tool inputs scoped to the minimum content needed for the task.
• Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/send-a-greeting-card
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase