POST
/
send
/
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
}

Authorizations

Authorization
string
header
required

Bearer token authentication using your thanks.io API key

Body

application/json

Response

Send Mailer Success

Response when an Order is successfully submitted to Send Mailer