Contact_Import
Contact_Import( string key, array contacts, string source,optional struct optionalParameters)
Description
Import a collection of contacts. Can import up to 1000 contacts with a single call. This call can be used to import new contacts or update existing contacts.
Parameters
string | key | Your API key - used to authenticate your account | |
array | contacts | Array of contact_hash items, as explained above contacts is an array of structs, where each struct can contain: - email => value - customFieldToken => value - customFieldId => value Each contact_hash must have a valid email Ex: contacts = [ {"email":"test@mail2.com", "first_name":"Test", "last_name":"User"}, {"email":"support@mail2.com", 1:"Support", 2:"User"} ]; |
|
string | source | A short description of the source of your contacts | |
optional | bool | triggerWorkflows | Triggers all workflows for which the contact is eligible - defaults to false |
optional | struct | optionalParameters | A struct of optional parameters, see below for valid keys |
optionalParameters can include:
array | listIds | Import these contacts into all of the specified lists |
array | groupIds | Import these contacts into all of the specified lists |
bool | activateDeleted | If this contact was already deleted, reactivate them - defaults to true |
bool | updateCustomFields | If this contact already exists, replace custom field values with values provided - defaults to false |
Return
struct | Aggregate import results |