Description
Add contacts to group specified. Accepts GET or POST requests.
URL
https://melotext.com/apis/addcontact/
Example Call: https://melotext.com/apis/addcontact/?apikey=APIKEY&group=GROUPNAME&number=PHONENUMBER&name=NAME&email=EMAIL&bday=BDAY
PHP Code Sample (cURL):
$url = 'https://melotext.com/apis/addcontact/'; $fields = array('apikey' => $api_key, 'group' => $group_name, 'number' => $number, 'name' => $name, 'email' => $email, 'bday' => $bday, ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($fields)); curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded')); $result = curl_exec($ch); return $result;
Parameters
Parameters | Required | Description |
---|---|---|
apikey | Required | The API key of your account |
group | Required | The name of the group yo uare associating this contact to. Must be a valid group name that already exists in the system. |
number | Required | The number of the contact. NO spaces, dashes, or parentheses in phone numbers. |
name | Optional | The name of the contact. |
Optional | The email address of the contact. | |
bday | Optional | The birthday of the contact. Format: YYYY-MM-DD |
Return Values
Return Code | Description |
---|---|
0 | 0 is passed back on successful API call. |
-1 | Invalid API key passed in. |
-2 | There was no number passed in. |
-3 | Group and number required. |
-4 | There was no group passed in. |
-5 | The group passed in is invalid or does not exist in the group list. |
-6 | Other error. |
-7 | Number is already subscribed for [group name]. |
-20 | Level 1 does not have access to the API. API can only be used with Levels 2, 3, and 4. |