POST
/
send
/
notecard
curl --request POST \
--url https://api.thanks.io/api/v2/send/notecard \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"front_image_url": "https://d2md0c8rpvzmz5.cloudfront.net/notecard-inspirations/note1.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.",
"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": 1,
"authorization_total": 200,
"leads_fee": 0,
"mailing_list_ids_used": "",
"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.",
"append_or_current_resident": true,
"type": "notecard",
"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": null,
"custom_background_url": "https://s3.amazonaws.com/content-staging.thanks.io/templates/branding-builder-images/c09d39aadfc-3701d4467b8/44e9a510-78cb-11f0-a77d-dd13e72edce5.png",
"giftcard_brand": null,
"giftcard_image": null,
"giftcard_amount": null,
"status": "reviewing",
"style": 4,
"user_id": 2,
"updated_at": "2025-08-15 04:24:50",
"created_at": "2025-08-15 04:24:50",
"id": 42680,
"display_status": "Reviewing",
"display_trigger": "API",
"display_type": "Notecard",
"giftcard_brand_longname": "",
"sub_account": null,
"recipients": [
{
"name": "Current Resident",
"address": "1 Main Street",
"city": "Anytown",
"province": "NY",
"postal_code": "55555",
"country": "US",
"address2": ""
}
]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Response

200
application/json

Send Mailer Success

Response when an Order is successfully submitted to Send Mailer