Direct Mail Postcard API

DirectMailers postcards are digitally printed on high-quality 110 lb. film laminated stock and die cut with rounded corners.
All postcards include full 4/4 color printing on both sides.

HIGHEST QUALITY

Every letter starts with superior substrates and is executed using the highest quality printing. Quality matters, DirectMailers print products are second to none.

TRACKABLE

Stay compliant, stay informed. Individual postcard tracking, and delivery events are available on every API call.

SCALABLE

Use the power of the cloud to scale your postcard mailings. Scale up and down as needed with no upfront fees or long-term commitments.


FLEXIBLE CREATIVE

Print with flat / pre-rendered images or use powerful HTML5 + CSS3 templates for quick customization and unlimited possibilities with variable data and objects.

VARIABLE DATA

Templates allow easy personalization and placement of variable data for unlimited possibilities helping to drive your message and connect to your customer.

Sample Postcard API Request

In this quick example we will action a postcard that utilizes a template for the front and back of the card. The template allows us to use the “VariablePayload” object to pass in variable data for replacing in the template. More information on the postcard object can be found in the documentation

{
	"Front": "924edd2d-9223-41df-877a-54c523b91bb7",
	"Back": "c0f266e9-a64c-42d7-97ad-e090f8275c13",
	"WaitForRender" : true,
	"VariablePayload": {
		"FIRSTNAME" : "Mike",
        "DISCOUNT": "50",
        "CITY" : "Las Vegas",
        "PURL" : "Travel.com/BSHS893",
        "PHONENUMBER" : "(800) 555-1212",
        "SENDERFIRSTNAME" : "Steve",
        "IMAGEURL" : "https://dmprint.s3.amazonaws.com/resources/clientExamples/CA_SASS/NV.jpeg"
	},
	"Description": "Sample Request",
	"Size": "4.25x6",
	"DryRun": false,
	"To": {
    	"Name": "Mike Smith",
    	"AddressLine1": "123 Main St",
    	"City": "Paducah",
    	"State": "KY",
    	"Zip": "42001"
	},
	"From": {
		"Name": "ACME Travel",
		"AddressLine1": "8808 North Central Ave. Suite #108",
		"City": "Phoenix",
		"State": "AZ",
		"Zip": "85020"
	}
}

Sample Postcard API Response

The JSON object below represents all the data passed back from a postcard POST request. Every data point about the postcard is available as well as links to rendered PDFs and low-resolution JPGs are returned.

{
    "PrintRecord": "633f03f3-1df5-4aac-9e6a-a0ee099c7041",
    "Created": "2018-07-09T22:22:06+0000",
    "MailingDate": "2018-07-10T00:00:00+0000",
    "Canceled": false,
    "Status": "Pre-Production",
    "Description": "Sample Request",
    "Medium": "Postcard",
    "Size": "4.25x6",
    "Front": "924edd2d-9223-41df-877a-54c523b91bb7",
    "Back": "c0f266e9-a64c-42d7-97ad-e090f8275c13",
    "VariablePayload": {
        "FIRSTNAME": "Mike",
        "DISCOUNT": "50",
        "CITY": "Las Vegas",
        "PURL": "Travel.com/BSHS893",
        "PHONENUMBER": "(800) 555-1212",
        "SENDERFIRSTNAME": "Steve",
        "IMAGEURL": "https://dmprint.s3.amazonaws.com/resources/clientExamples/CA_SASS/NV.jpeg"
    },
    "Cost": 0.56,
    "DryRun": false,
    "RenderedPdf": "https://dmprint.s3-us-west-2.amazonaws.com/assets/8cd342281d4301e058e5d741fc67ed4a3d1c3c7ef16928440d8c05a0ff956483.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=9cbb2ab5862940644769b9be02a64c61eccc83f07e899586facd90c9e6d6019e",
    "PostalCarrier": "USPS",
    "PostalClass": "First Class",
    "To": {
        "Name": "Mike Smith",
        "AddressLine1": "123 Main St",
        "AddressLine2": null,
        "City": "Paducah",
        "State": "KY",
        "Zip": "42001"
    },
    "From": {
        "Name": "ACME Travel",
        "AddressLine1": "8808 North Central Ave. Suite #108",
        "AddressLine2": null,
        "City": "Phoenix",
        "State": "AZ",
        "Zip": "85020"
    },
    "FrontThumbnails": {
        "Small": "https://dmprint.s3-us-west-2.amazonaws.com/assets/cd22cd8ec92ddcddc0de07f5b6c71f0e3e22bba81a3daf1f8a059a49c13be8e5.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=33b4a12b67dcd830c49e79c31d69cb83b6524f2e7d7afc35b3a36ea2f819530d",
        "Medium": "https://dmprint.s3-us-west-2.amazonaws.com/assets/9df1778c77b735b0ecfb128bf8afa443b1c02eee3f0e501cbf56692a38bbfb27.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=b3b0b91403deef262b0b96d40d9320b757ce8f1fdbcad65556bd81ff0505e1e4",
        "Large": "https://dmprint.s3-us-west-2.amazonaws.com/assets/007b52811896b286b2141dcca1919abbe5fc464f78455deca1c4b45e8d86c13b.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=cccfa8e3c3c1c32e24deec29dc919f769e2c09f8bf540d69088a0dea82b2f623"
    },
    "BackThumbnails": {
        "Small": "https://dmprint.s3-us-west-2.amazonaws.com/assets/3a3cabfc7cbfd5b4dfff81778fa18fd8b4fe24d9ee66ba9585642e77c981215d.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=831aae414aa0b95fa70e1d897d01a8abd6379e6f711b3e0e690e1a78c74f4c94",
        "Medium": "https://dmprint.s3-us-west-2.amazonaws.com/assets/34b21a449dff50ba3c7bb981ff9b2163d29d46c3d062b0861b5a489aaf5187d9.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=204a715ae2604cf0e5c59884484623e71492716b691668c676ce53d503b1937c",
        "Large": "https://dmprint.s3-us-west-2.amazonaws.com/assets/11c18018e966de6dc34917a85afb287e442ff190b4eb1f571565877de7df0f8d.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAINYRYKOPG5CLM5LA%2F20180709%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20180709T222210Z&X-Amz-SignedHeaders=host&X-Amz-Expires=518400&X-Amz-Signature=5ca8831e99985ad4165113b9c38857519a80bd3e05186bed0411b233e6d2638b"
    },
    "TrackingEvents": [],
    "EstimatedDeliveryDate": "2018-07-16T00:00:00+0000",
    "ActualDeliveryDate": null
}

Trigger Programmatic Postcards and Drive Results

  • STARTUP
                                                                  
  • $0.56
    Per 4.25×6″ Postcard
  • No Contracts or Subscriptions
  • Pricing Details
  • ENTERPRISE
    5,000 Monthly Aggregate Volume
  • $0.50
    Per 4.25×6″ Postcard
  • No Contracts or Subscriptions
  • Pricing Details

Get Started with the DirectMailers Print API Today.

We are excited to get started with you and your team. Feel free to drop us a line and let us know how we can help!
Get StartedDocumentation Contact Support Team