Submit a Mailing List Job

Runs a mailing list job. Mailing list jobs allow you to add or remove contacts to your mailing list from mailing list imports or directly with contact IDs. Only one job can be ran at a time and jobs are only able to be ran while the mailing list has a status of "completed".

Once a job as successfully been kicked off, the mailing list will have a status of either creating_contacts or removing_contacts depending on which job was ran. After the job has finished, the mailing list will go back into the completed state where more jobs can be ran. If there are any errors while running a job, the errors field on the mailing list will contain a list of error objects which describe the errors.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
addContacts
array of strings
length between 1 and 500

List of contact IDs to add to the mailing list. Cannot be used with other operations.

addContacts
removeContacts
array of strings
length between 1 and 500

List of contact IDs to remove from the mailing list. Cannot be used with other operations.

removeContacts
addMailingListImports
array of strings
length between 1 and 10

List of mailing list import IDs to add to the mailing list. Cannot be used with other operations.

addMailingListImports
removeMailingListImports
array of strings
length between 1 and 10

List of mailing list import IDs to remove from the mailing list. Cannot be used with other operations.

removeMailingListImports
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json