curl --request POST \
--url https://api.thanks.io/api/v2/send/postcard \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"size": "4x6",
"front_image_url": "https://s3.amazonaws.com/cdn.thanks.io/user_image_library/gFBaJJJWRp60op3ZOoK7UaO5I7zi33rdKQGgHylR.png",
"message": "Hey %FIRST_NAME%!,\n\nTHANK YOU for allowing us the opportunity to HELP you with your plan!",
"handwriting_style": 4,
"recipients": [
{
"name": "Current Resident",
"address": "123 Main Street",
"city": "Fake City",
"province": "NY",
"postal_code": "55555",
"country": "US",
"custom1": "Example Custom 1",
"custom2": "Example Custom 2",
"custom3": "Example Custom 3",
"custom4": "Example Custom 4"
},
{
"name": "Jane Doe",
"address": "456 Another St",
"city": "Fake City",
"province": "NY",
"postal_code": "55555",
"country": "US"
}
]
}'
{
"total_estimated_recipients": 2,
"authorization_total": 116,
"leads_fee": 0,
"mailing_list_ids_used": "3046,3020",
"handwriting_color": "rgba(31,0,113,0.80)",
"front_image": "https://s3.amazonaws.com/cdn.thanks.io/user_image_library/1533645532.png",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
"append_or_current_resident": true,
"type": "postcard",
"return_name": null,
"return_address": null,
"return_address2": null,
"return_city": null,
"return_province": null,
"return_postal_code": null,
"message_template_id": null,
"image_template_id": 6,
"method": "api",
"sub_account_id": null,
"font_size": "auto",
"qrcode_url": "https://www.google.com?name=~FULL_NAME~&custom_field_1=~CUSTOM1~&custom_field2=~CUSTOM2~",
"size": "4x6",
"custom_background_url": "https://s3.amazonaws.com/content-staging.thanks.io/templates/branding-builder-images/c09d39aadfc-3701d4467b8/4524cce0-78cb-11f0-b937-17570cbedaf4.png",
"giftcard_brand": null,
"giftcard_image": null,
"giftcard_amount": null,
"status": "reviewing",
"addons": {
"standardmail": "on"
},
"style": 4,
"user_id": 2,
"updated_at": "2025-08-14 16:48:13",
"created_at": "2025-08-14 16:48:13",
"id": 42665,
"display_status": "Reviewing",
"display_trigger": "API",
"display_type": "Postcard-4x6",
"handwriting_image": null,
"giftcard_brand_longname": "",
"sub_account": null
}
Send a 4x6, 6x9, or 6x11 postcard.
curl --request POST \
--url https://api.thanks.io/api/v2/send/postcard \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"size": "4x6",
"front_image_url": "https://s3.amazonaws.com/cdn.thanks.io/user_image_library/gFBaJJJWRp60op3ZOoK7UaO5I7zi33rdKQGgHylR.png",
"message": "Hey %FIRST_NAME%!,\n\nTHANK YOU for allowing us the opportunity to HELP you with your plan!",
"handwriting_style": 4,
"recipients": [
{
"name": "Current Resident",
"address": "123 Main Street",
"city": "Fake City",
"province": "NY",
"postal_code": "55555",
"country": "US",
"custom1": "Example Custom 1",
"custom2": "Example Custom 2",
"custom3": "Example Custom 3",
"custom4": "Example Custom 4"
},
{
"name": "Jane Doe",
"address": "456 Another St",
"city": "Fake City",
"province": "NY",
"postal_code": "55555",
"country": "US"
}
]
}'
{
"total_estimated_recipients": 2,
"authorization_total": 116,
"leads_fee": 0,
"mailing_list_ids_used": "3046,3020",
"handwriting_color": "rgba(31,0,113,0.80)",
"front_image": "https://s3.amazonaws.com/cdn.thanks.io/user_image_library/1533645532.png",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
"append_or_current_resident": true,
"type": "postcard",
"return_name": null,
"return_address": null,
"return_address2": null,
"return_city": null,
"return_province": null,
"return_postal_code": null,
"message_template_id": null,
"image_template_id": 6,
"method": "api",
"sub_account_id": null,
"font_size": "auto",
"qrcode_url": "https://www.google.com?name=~FULL_NAME~&custom_field_1=~CUSTOM1~&custom_field2=~CUSTOM2~",
"size": "4x6",
"custom_background_url": "https://s3.amazonaws.com/content-staging.thanks.io/templates/branding-builder-images/c09d39aadfc-3701d4467b8/4524cce0-78cb-11f0-b937-17570cbedaf4.png",
"giftcard_brand": null,
"giftcard_image": null,
"giftcard_amount": null,
"status": "reviewing",
"addons": {
"standardmail": "on"
},
"style": 4,
"user_id": 2,
"updated_at": "2025-08-14 16:48:13",
"created_at": "2025-08-14 16:48:13",
"id": 42665,
"display_status": "Reviewing",
"display_trigger": "API",
"display_type": "Postcard-4x6",
"handwriting_image": null,
"giftcard_brand_longname": "",
"sub_account": null
}
Bearer token authentication using your thanks.io API key
Send Mailer Success
Response when an Order is successfully submitted to Send Mailer
Was this page helpful?