DirectMailers Print APIDirectMailers Print API
Menu
 
 
 

Direct Mail Postcard API

DirectMailers postcards are full four over four digitally printed on high-quality 110 lb. film laminated stock and die cut with rounded corners.
Postcard pricing starts at $0.62 including print, postage and tracking.

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.

Trigger Programmatic Postcards and Drive Results

  • STARTUP
    0 – 1,999 Monthly Aggregate Volume
  • $0.680
    Per 4.25×6″ Postcard
  • All Inclusive Pricing (Print & Postage)
  • Detailed Reporting
  • Per Piece Tracking
  • Email Support
  • No Contracts or Subscriptions
  • Pricing Details
  • BUSINESS
    2,000 Monthly Aggregate Volume
  • $0.650
    Per 4.25×6″ Postcard
  • All Inclusive Pricing (Print & Postage)
  • Detailed Reporting
  • Per Piece Tracking
  • Phone Support
  • No Contracts or Subscriptions
  • Pricing Details
  • ENTERPRISE
    5,000 Monthly Aggregate Volume
  • $0.620
    Per 4.25×6″ Postcard
  • All Inclusive Pricing (Print & Postage)
  • Detailed Reporting
  • Per Piece Tracking
  • Phone Support
  • No Contracts or Subscriptions
  • Pricing Details

Sample Postcard API Request Object

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” array to pass in variable data for replacing placeholders 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 Object

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.50,
"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
}

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