Send a Custom Greeting Card by Apoth3osis

Name: Send a Custom Greeting Card
Brand: Apoth3osis
SKU: 6985fead269243768b447d9b
Price: 4.00 USD
Availability: InStock

Send a Custom Greeting Card

Physical

Available ActionsEach successful request consumes credits as outlined below.

render_preview^400crcreate_proof^400crsend^400crget_order_status^400crget_tracking^400crlist_orders^400cr

Details

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.

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

Credentials

Mailing Return Address *

Your mailing return address that will appear on postcards, certified mail, and greeting cards.

custom object

Manage credentials in your dashboard.

Actions(6)

render_preview^400cr15 params

Generate a preview of the greeting card without mailing. Returns the generated PDF and preview images with signed URLs for review before sending.

orientationstring

Card orientation. horizontal: landscape panels, card folds along top edge. vertical: portrait panels, card folds along left edge.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels. handwritten = blue pen-on-paper, elegant = charcoal formal, modern = clean contemporary, classic = traditional black.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG). Required for card builder mode.

front_cover_image_file_idstring

File ID of front cover image. Alternative to URL for card builder mode.

inside_left_textstring

Text for inside left panel (visible when card is opened, left side).

inside_left_image_urlstring

Image URL for inside left panel. Provide text OR image for each panel, not both.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area. Provide text OR image, not both.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card (small branding, attribution, etc.).

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode, mutually exclusive with card builder fields).

document_pdf_file_idstring

File ID of a print-ready PDF in cloud storage (raw PDF mode).

create_proof^400cr16 params(1 required)

Upload the card to Click2Mail and create the print job without mailing. Used for final review before committing to send.

recipient_addressrequiredobject

Recipient mailing address (US only). Must include name or organization.

Properties:

name(string)- Recipient full name.

organization(string)- Organization name (can be used instead of or with name).

address1*(string)- Street address line 1.

address2(string)- Street address line 2.

city*(string)- City.

state*(string)- Two-letter state code.

postal_code*(string)- ZIP code.

orientationstring

Card orientation. horizontal: landscape panels. vertical: portrait panels.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG).

front_cover_image_file_idstring

File ID of front cover image.

inside_left_textstring

Text for inside left panel.

inside_left_image_urlstring

Image URL for inside left panel.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card.

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode).

document_pdf_file_idstring

File ID of a print-ready PDF (raw PDF mode).

send^400cr16 params(1 required)

Generate the card PDF, print it on premium cardstock, fold it, envelope it, and mail it via USPS First Class to the recipient address.

recipient_addressrequiredobject

Recipient mailing address (US only). Must include name or organization.

Properties:

name(string)- Recipient full name.

organization(string)- Organization name (can be used instead of or with name).

address1*(string)- Street address line 1.

address2(string)- Street address line 2.

city*(string)- City.

state*(string)- Two-letter state code.

postal_code*(string)- ZIP code.

orientationstring

Card orientation. horizontal: landscape panels. vertical: portrait panels.

Values:

horizontalvertical

Default: horizontal

font_stylestring

Font style for text panels.

Values:

handwrittenelegantmodernclassic

Default: handwritten

front_cover_image_urlstring

URL to front cover image (JPG/PNG).

front_cover_image_file_idstring

File ID of front cover image.

inside_left_textstring

Text for inside left panel.

inside_left_image_urlstring

Image URL for inside left panel.

inside_left_image_file_idstring

File ID for inside left image.

inside_right_textstring

Text for inside right panel — the main message area.

inside_right_image_urlstring

Image URL for inside right panel.

inside_right_image_file_idstring

File ID for inside right image.

back_textstring

Text for back of card.

back_image_urlstring

Image URL for back of card.

back_image_file_idstring

File ID for back image.

document_pdf_urlstring

Public URL to a print-ready 2-page PDF (raw PDF mode).

document_pdf_file_idstring

File ID of a print-ready PDF (raw PDF mode).

get_order_status^400cr1 param(1 required)

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

order_idrequiredstring

Order ID returned from a previous send or create_proof call.

get_tracking^400cr2 params(1 required)

Get USPS tracking details for a previously sent card order.

order_idrequiredstring

Order ID returned from a previous send call.

tracking_typestring

Tracking type. Default: IMB.

Values:

IMBIMPB

list_orders^400cr1 param

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

limitinteger

Number of orders to return.

Default: 10

Range: 1 - 50

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6985fead269243768b447d9b",
    "parameters": {
      "action": "render_preview",
      "orientation": "horizontal",
      "font_style": "handwritten"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6985fead269243768b447d9b",
    "parameters": {
        "action": "render_preview",
        "orientation": "horizontal",
        "font_style": "handwritten"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6985fead269243768b447d9b",
  parameters: {
    "action": "render_preview",
    "orientation": "horizontal",
    "font_style": "handwritten"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6985fead269243768b447d9b",
  parameters: {
    "action": "render_preview",
    "orientation": "horizontal",
    "font_style": "handwritten"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

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)

Call render_preview with the card content to generate a proof.
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.
Once the user approves, call send with the same card content plus recipient_address.

Create proof then approve

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

Check delivery status

After sending, save the order_id from the response.
Call get_order_status with that order_id to check printing and mailing status.
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).

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 6985fead269243768b447d9b ("Send a Custom Greeting Card"). Then call the same tool with action 'call_tool', tool_id 6985fead269243768b447d9b, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.