Create Multiple Recipients

Authorizations

Authorization

string

header

required

Bearer token authentication using your thanks.io API key

Body

application/json

Create Recipient by Address
Create Recipient by Email

Create a recipient by providing address details

mailing_list_id

integer

required

Example:

1

address

string

required

Example:

"123 Main Street"

name

string

Example:

"Tobias Example"

company

string

Example:

"thanks.io"

address2

string

Example:

"Apartment 1"

city

string

Example:

"Any Town"

province

string

State or Province

Example:

"KS"

postal_code

string

Example:

"12345"

country

string

Example:

"US"

dob

string

Date of Birth in ISO 8601 format (YYYY-MM-DD) or null if not set. If provided as MM/DD/YYYY in requests, it will be converted to ISO 8601 format.

Example:

"1981-04-23"

anniversary

string

Can be used for house purchase anniversaries, move-in dates, or any recurring annual milestone. Anniversary date in ISO 8601 format (YYYY-MM-DD) or null if not set. If provided as MM/DD/YYYY in requests, it will be converted to ISO 8601 format.

Example:

"2025-07-21"

string

Example:

"tobias@example.com"

phone

string

Example:

"+1 (555) 123-4567"

custom1

string

Custom field for additional information about the recipient

Example:

"Unique Info"

custom2

string

Custom field for additional information about the recipient

Example:

"For example a product code or customer ID"

custom3

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom4

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom5

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom6

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom7

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom8

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom9

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom10

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

absentee_address

string

The property (absentee) address for this recipient, such as a house an absentee owner owns, as opposed to where they get mail. Give either the whole address here, or the street line here with absentee_city, absentee_province and absentee_postal_code. When set, the ~ABSENTEE_STREET~, ~ABSENTEE_FULL_ADDRESS~, ~FULL_ADDRESS~ and ~STREET_VIEW~ image template variables, and %ABSENTEE_STREET% in messages, use this address instead of the mailing address. The mailer is still delivered to address. Include the city, state and ZIP so Street View finds the right property. It is stored and returned in its own absentee_address field, and also copied into custom2 when that is empty, so templates that print %CUSTOM2% keep working; a custom2 you send is never changed. The older convention of custom1 = absentee with custom2 = the property address is still accepted and copied into absentee_address.

Example:

"742 Evergreen Terrace"

absentee_city

string

City of the absentee (property) address. Requires absentee_address in the same request.

Example:

"Springfield"

absentee_province

string

State or province of the absentee (property) address. Requires absentee_address in the same request.

Example:

"IL"

absentee_postal_code

string

ZIP or postal code of the absentee (property) address. Requires absentee_address in the same request.

Example:

"62704"

Example:

[
  {
    "mailing_list": 1,
    "name": "Tobias First",
    "address": "987 Main Street",
    "address2": null,
    "city": "LENEXA",
    "province": "KS",
    "postal_code": "66216",
    "country": "US",
    "dob": "04/23/1981",
    "anniversary": "04/23/2025",
    "custom1": null,
    "custom2": null,
    "email": "testemail@thanks.io",
    "phone": "1234567890"
  },
  {
    "mailing_list": 1,
    "email": "another-testemail@thanks.io",
    "phone": "1234567890"
  }
]

Response

200 - application/json

integer

read-only

Example:

18113288

mailing_list_id

integer

Example:

1

name

string

Example:

"Tobias Example"

company

string

Example:

"thanks.io"

address

string

Example:

"123 Main Street"

address2

string

Example:

"Apartment 1"

city

string

Example:

"Any Town"

province

string

State or Province

Example:

"KS"

postal_code

string

Example:

"12345"

country

string

Example:

"US"

dob

string

Date of Birth in ISO 8601 format (YYYY-MM-DD) or null if not set. If provided as MM/DD/YYYY in requests, it will be converted to ISO 8601 format.

Example:

"1981-04-23"

anniversary

string

Example:

"2025-07-21"

string

Example:

"tobias@example.com"

phone

string

Example:

"+1 (555) 123-4567"

custom1

string

Custom field for additional information about the recipient

Example:

"Unique Info"

custom2

string

Custom field for additional information about the recipient

Example:

"For example a product code or customer ID"

custom3

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom4

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom5

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom6

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom7

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom8

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom9

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

custom10

string

Custom field for additional information about the recipient

Example:

"Any Extra Info"

absentee_address

string | null

The property (absentee) address the absentee image template and message variables use, or null when none is set. Mail is delivered to address, not here.

Example:

"742 Evergreen Terrace, Springfield, IL 62704"

mailing-list

object

The mailing list this recipient belongs to

Show child attributes

created_at

string

read-only

Example:

"2025-06-27T14:57:11.000000Z"

updated_at

string

read-only

Example:

"2025-06-27T14:57:11.000000Z"

Get Started

Authentication

API Endpoints

Examples

Authorizations

Body

Response