Skip to content

Create Lists

Endpoint

http
POST /unified/marketing-automation/lists
Integrations supported
  • Constant Contact
  • GetResponse
  • Mailchimp

Query parameters

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d

Request Body

Refer Writing data using Unified APIs

name
string
The list's name
Required in
  • Constant Contact
  • GetResponse
  • Mailchimp
description
string
The list's description
Supported in
  • Constant Contact
contact
object
The contact information for the list
Supported in
  • Mailchimp
company
string
REQUIRED · The company name
address1
string
REQUIRED · The first line of the company's address
city
string
REQUIRED · The city of the company's address
country
string
REQUIRED · The country of the company's address
address2
string
The second line of the company's address
state
string
The state of the company's address
zip
string
The zip code of the company's address
phone
string
The company's phone number
campaign_defaults
object
The default values for campaigns created for this list
Required in
  • Mailchimp
from_name
string
REQUIRED · The default from name for campaigns sent from this list
from_email
string
REQUIRED · The default from email for campaigns sent from this list
subject
string
REQUIRED · The default subject line for campaigns sent from this list
language
string
REQUIRED · The default language for this list's forms
remote_data
object
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

Response Body

id
string
REQUIRED · The list's unique identifier
Supported in
  • Constant Contact
  • GetResponse
  • Mailchimp
name
string
The list's name
Supported in
  • Constant Contact
  • GetResponse
  • Mailchimp
description
string
The list's description
Supported in
  • Constant Contact
  • GetResponse
type
string
The list's type
updated_at
string · date-time
The date and time of the list's last update
Supported in
  • Constant Contact
created_at
string · date-time
The date and time of the list's creation
Supported in
  • Constant Contact
  • GetResponse
  • Mailchimp
remote_data
object
Raw data returned from the remote API call.