Skip to main content
POST
Create Contact

Authorizations

Authorization
string
header
required

Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.

Headers

Content-Type
string
default:application/json
required

Request body type

Body

application/json
email
string
required

The email for the contact. This is required to be a valid email.

Maximum: 200

Maximum string length: 200
list_id
string
required

The contact list id to which you want to add this contact

Minimum string length: 1
city
string

The city of the contact

Maximum: 100

Maximum string length: 100
country
string

The country of the contact

Maximum: 50

Maximum string length: 50
custom_fields
object

Json for custom property

Text - maximum: 100

Textarea - maximum: 500

Number - Numeric values only

Date - maximum: 10,format = 2006-01-02

department
string

The department of contact

Maximum: 100

Minimum string length: 1
industry
string

The industry of the contact

Maximum: 100

Maximum string length: 100
job_title
string

The job title of the contact

Maximum: 100

Maximum string length: 100
last_name
string

The last name for the contact

Maximum: 25

Maximum string length: 25
lead_source
string

The lead sorce of contact

Maximum: 50

Maximum string length: 50
middle_name
string

The middle name of contact

Maximum: 25

Maximum string length: 25
first_name
string

Name of your contact

Maximum: 25

Maximum string length: 25
company_name
string

The company name of your contact

Maximum: 150

Maximum string length: 150
phone
string

The phone number of your contact

Maximum: 25

Minimum string length: 1
salary
number

The salary of your contact

Maximum: 15

state
string

The state of your contact

Maximum: 100

Maximum string length: 100
postal_code
string

The postal code of your contact

Maximum: 25

Maximum string length: 25
contact_type
string
default:active

Allowed values - active, bounce, abuse, unsubscribe, suppressed, spam complaints

Default: active

tags
any[]

The tags of your contact

Response

Created