Add New Contact
The Add New Contact method allows you to add a contact to a specific already created list.
The parameter "contactGender" can accept values other than integers, such as:
- Not known: ['', 'unknown', 'undefined', 'empty'];
- Male: ['m', 'male'];
- Female: ['f', 'female'];
- Not applicable: ['n/a', 'not applicable', 'na'].
Important!
The format for various time zones.
Request
IMPORTANT: Do not send more than 10 concurrent API requests.
Body Example
Parameters
Title | Type | Default | Description |
---|---|---|---|
contactListId required
|
string |
ID of the contact list where the contact to be updated belongs. |
|
webHookUri optional
|
string |
The Wooxy will send a |
|
contacts required
|
array |
An array of contact information.
|
|
contacts.name optional
|
string |
The optional display name to use for the recipient. |
|
contacts.email optional
|
string |
Contact’s email address. |
|
contacts.phoneNumber optional
|
string |
|
|
contacts.userId optional
|
string |
Contact’s unique user ID from your platform to enable management of the contact in the list based on it. |
|
contacts.active optional
|
boolean | false |
You can set if the contact is enabled on the contact list or not.
|
contacts.emailSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving emails or not.
|
contacts.smsSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving SMS or not.
|
contacts.desktopWebPushSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving desktop WebPush notifications or not.
|
contacts.mobileWebPushSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving mobile WebPush notifications or not.
|
contacts.telegramSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving Telegram messages or not.
|
contacts.viberSubscribe optional
|
boolean | false |
You can set if the contact is subscribed to receiving Viber communications or not.
|
contacts.firstName optional
|
string |
Contact’s first name. |
|
contacts.lastName optional
|
string |
Contact’s last name. |
|
contacts.contactBirthday optional
|
string |
Contact’s birth date in |
|
contacts.contactLanguage optional
|
string |
Contact’s locale in |
|
contacts.contactGender optional
|
integer | 0 |
Contact’s gender in
|
contacts.contactTimezone optional
|
string |
Contact’s timezone in |
|
contacts.contactScore optional
|
integer | null |
Contact Score. |
contacts.avatarLink optional
|
string |
Link to contact’s avatar image. |
|
contacts.facebookLink optional
|
string |
Link to contact’s Facebook profile. |
|
contacts.instagramLink optional
|
string |
Link to contact’s Instagram profile. |
|
contacts.linkedInLink optional
|
string |
Link to contact’s LinkedIn profile. |
|
contacts.twitterLink optional
|
string |
Link to contact’s Twitter profile. |
|
contacts.tiktokLink optional
|
string |
Link to contact’s TikTok profile. |
|
variables optional
|
array | null |
An array of contact variables and their values. |
variables.name required
|
string |
Variable name in lowerCamelCase format. |
|
variables.value required
|
string |
Variable value in |
|
sourceId optional
|
string |
Contact’s unique source ID from Wooxy platform. |
|
customerSourceId optional
|
string |
Contact’s unique source ID from your system to synchronize two sides. |
|
cac optional
|
object | null |
An object that contains comprehensive data regarding the cost of acquiring customers comprises of the value and currency." of the value and currency. |
cac.value required
|
float |
CAC value in |
|
cac.currency required
|
string |
(EUR, USD) |
Response
Parameters
Title | Type | Description |
---|---|---|
result |
boolean |
The value indicates that the contact was successfully added to your contact list:
|
requestId |
string |
A unique request ID will be used to match the specific “Add contact” request with the Status Webhook, which will be sent by Wooxy after the request is processed. |
Method Errors
Error |
---|
“Argument contactListId must be a non-empty string” |
“Argument webHookUri must be a valid URI” |
“add at least one valid contact to contacts field” |
“Argument name must be a string” |
“invalid RFC2822 email {email} at email field” |
“Argument email must be a string” |
“Argument phoneNumber must be a string” |
“{phoneNumber} is not a valid E.164 phone number” |
“Argument userId must be a string” |
"Argument userId must be less than 125 symbols" |
“Argument active can be true or false” |
“Argument emailSubscribe can be true or false” |
“Argument smsSubscribe can be true or false” |
“Argument desktopWebPushSubscribe can be true or false” |
“Argument mobileWebPushSubscribe can be true or false” |
“Argument variables must be an array of arrays with \”name\” and \”value\” fields” |
“name of variable must be a string” |
“name of variable can not be empty” |
“variable \”{name}\” is reserved and can not be added as custom variable” |
“invalid name of variable {name}” |
“List with id {contactListId} not found!” |
“email, phoneNumber or userId must be filled at contact position {i}” |
“Argument {argument} required” |
“Argument firstName must be a string” |
“Argument firstName must be a string with max length within 255 characters” |
“Argument lastName mustbe a string” |
“Argument lastName must be a string with max length within 255 characters” |
“Argument birthday must be a YYYY-MM-DD date” |
“Argument language must be a valid ISO language” |
“Unknown gender value” |
“Argument timezone must be a valid timezone string” |
“Argument score must have a numeric value” |
“Argument avatarLink must be a valid URL” |
“Argument facebookLink must be a valid URL” |
“Argument instagramLink must be a valid URL” |
“Argument linkedInLink must be a valid URL” |
“Argument twitterLink must be a valid URL” |
“Argument tiktokLink must be a valid URL” |
“Argument sourceId must be a string” |
“sourceId {sourceId} not found in your account at contact position {i}” |
“Argument customerSourceId must be an alphanumeric string with max length within 40 characters” |
“Argument CAC must be an array with value and currency fields” |
“CAC value must be a positive float” |
“CAC currency {currency} not allowed. USD, EUR are” |
“Variable {name} type is date, but value is not valid date. Value {value}” |
“Variable {name} not found in list. Try to add it first” |
“Request saving error. Please, contact us or try again later” |
“Invalid authorization token!” |
“Internal server error” |
“Bad Request” |
“no matches found for access token {accessToken}” |
“user {id} not enabled” |
“no data found for key {userId}” |
“access token check failed for key\/secret $key \/$accessToken” |