V3 REFERENCE Contact Lists

contact/managemanycontacts

Uploading many contacts and returns a job_id. To monitor the upload issue a GET request to: APIBASEURL/contact/managemanycontacts/:job_id

Retrieve the import background job status


curl -s -X GET \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
https://api.mailjet.com/v3/REST/contact/managemanycontacts/$JOBid

    
    
Properties
Name Description
ContactsLists A JSON Array with properties ListID - valid list_id and Action - one of the values "addforce", "addnoforce", "remove", "unsub".
  • [ Type TContactsListActionList ]
Contacts A JSON array. Each contact is represented by its Email, Name, Action to apply on the given contact, an optional exclusion state and Properties - a JSON object containing properties values for this contact.
  • Mandatory
  • [ Type TAddContactActionList ]

Start a new contacts import background job


curl -s -X POST \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
https://api.mailjet.com/v3/REST/contact/managemanycontacts \
-H 'Content-Type: application/json' \
-d '{"ContactsLists": ...}'
Properties
Name Description
ContactsLists A JSON Array with properties ListID - valid list_id and Action - one of the values "addforce", "addnoforce", "remove", "unsub".
  • [ Type TContactsListActionList ]
Contacts A JSON array. Each contact is represented by its Email, Name, Action to apply on the given contact, an optional exclusion state and Properties - a JSON object containing properties values for this contact.
  • Mandatory
  • [ Type TAddContactActionList ]