REST API PHP Code Examples

You are reading the REST API Code Examples. Click for the HTTP API.

Sending SMS Messages

Sends SMS text messages via a shared short code to a single phone number or an array of phone numbers.

Code Samples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'PhoneNumbers'  => array('2123456785', '2123456786', '2123456787', '2123456788'),
  'Groups'        => array('honey lovers'),
  'Subject'       => 'From Winnie',
  'Message'       => 'I am a Bear of Very Little Brain, and long words bother me',
  'StampToSend'   => '1305582245',
  'MessageTypeID' => 1
  );

$curl = curl_init('https://app.eztexting.com/sending/messages?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  // If you experience SSL issues, perhaps due to an outdated SSL cert
  // on your own server, try uncommenting the line below
  // curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $phoneNumbers = array();
  foreach( $xml->Entry->PhoneNumbers->children() as $phoneNumber ) {
    $phoneNumbers[] = (string) $phoneNumber;
  }

  $localOptOuts = array();
  foreach( $xml->Entry->LocalOptOuts->children() as $phoneNumber ) {
    $localOptOuts[] = (string) $phoneNumber;
  }

  $globalOptOuts = array();
  foreach( $xml->Entry->GlobalOptOuts->children() as $phoneNumber ) {
    $globalOptOuts[] = (string) $phoneNumber;
  }

  $groups = array();
  foreach( $xml->Entry->Groups->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Message ID : ' . $xml->Entry->ID . "\n" .
  'Subject: ' . $xml->Entry->Subject . "\n" .
  'Message: ' . $xml->Entry->Message . "\n" .
  'Message Type ID: ' . $xml->Entry->MessageTypeID . "\n" .
  'Total Recipients: ' . $xml->Entry->RecipientsCount . "\n" .
  'Credits Charged: ' . $xml->Entry->Credits . "\n" .
  'Time To Send: ' . $xml->Entry->StampToSend . "\n" .
  'Phone Numbers: ' . implode(', ' , $phoneNumbers) . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'Locally Opted Out Numbers: ' . implode(', ' , $localOptOuts) . "\n" .
  'Globally Opted Out Numbers: ' . implode(', ' , $globalOptOuts) . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'PhoneNumbers'  => array('2123456785', '2123456786', '2123456787', '2123456788'),
  'Groups'        => array('honey lovers'),
  'Subject'       => 'From Winnie',
  'Message'       => 'I am a Bear of Very Little Brain, and long words bother me',
  'StampToSend'   => '1305582245',
  'MessageTypeID' => 1
  );

$curl = curl_init('https://app.eztexting.com/sending/messages?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  // If you experience SSL issues, perhaps due to an outdated SSL cert
  // on your own server, try uncommenting the line below
  // curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $phoneNumbers = array();
  if ( !empty($json->Entry->PhoneNumbers) ) {
    $phoneNumbers = $json->Entry->PhoneNumbers;
  }

  $localOptOuts = array();
  if ( !empty($json->Entry->LocalOptOuts) ) {
    $localOptOuts = $json->Entry->LocalOptOuts;
  }

  $globalOptOuts = array();
  if ( !empty($json->Entry->GlobalOptOuts) ) {
    $globalOptOuts = $json->Entry->GlobalOptOuts;
  }

  $groups = array();
  if ( !empty($json->Entry->Groups) ) {
    $groups = $json->Entry->Groups;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Message ID : ' . $json->Entry->ID . "\n" .
  'Subject: ' . $json->Entry->Subject . "\n" .
  'Message: ' . $json->Entry->Message . "\n" .
  'Message Type ID: ' . $json->Entry->MessageTypeID . "\n" .
  'Total Recipients: ' . $json->Entry->RecipientsCount . "\n" .
  'Credits Charged: ' . $json->Entry->Credits . "\n" .
  'Time To Send: ' . $json->Entry->StampToSend . "\n" .
  'Phone Numbers: ' . implode(', ' , $phoneNumbers) . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'Locally Opted Out Numbers: ' . implode(', ' , $localOptOuts) . "\n" .
  'Globally Opted Out Numbers: ' . implode(', ' , $globalOptOuts) . "\n";
}

?>

Back to table of contents

Delete An Inbox Message

Delete an incoming text message in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/123?format=xml&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/123?format=json&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Get All Inbox Messages

Get all incoming text messages in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'sortBy'        => 'PhoneNumber',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif (! $xml->Entries->children() ) {
  echo 'Status: ' . $xml->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Total results: ' . $xml->Entries->children()->count() . "\n\n";

  foreach ( $xml->Entries->children() as $message) {
    echo 'Message ID : ' . $message->ID . "\n" .
    'Phone Number: ' . $message->PhoneNumber . "\n" .
    'Subject: ' . $message->Subject . "\n" .
    'Message: ' . $message->Message . "\n" .
    'New: ' . $message->New . "\n" .
    'Folder ID: ' . $message->FolderID . "\n" .
    'Contact ID: ' . $message->ContactID . "\n" .
    'Received On: ' . $message->ReceivedOn . "\n\n";
  }
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'sortBy'        => 'PhoneNumber',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif ( empty($json->Entries) ) {
  echo 'Status: ' . $json->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Total results: ' . count($json->Entries) . "\n\n";

  foreach ( $json->Entries as $message ) {
    echo 'Message ID : ' . $message->ID . "\n" .
    'Phone Number: ' . $message->PhoneNumber . "\n" .
    'Subject: ' . $message->Subject . "\n" .
    'Message: ' . $message->Message . "\n" .
    'New: ' . $message->New . "\n" .
    'Folder ID: ' . $message->FolderID . "\n" .
    'Contact ID: ' . $message->ContactID . "\n" .
    'Received On: ' . $message->ReceivedOn . "\n\n";
  }
}
?>

Back to table of contents

Get One Inbox Message

Get a single incoming text messages in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/123?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Message ID : ' . $xml->Entry->ID . "\n" .
  'Phone Number: ' . $xml->Entry->PhoneNumber . "\n" .
  'Subject: ' . $xml->Entry->Subject . "\n" .
  'Message: ' . $xml->Entry->Message . "\n" .
  'New: ' . $xml->Entry->New . "\n" .
  'Folder ID: ' . $xml->Entry->FolderID . "\n" .
  'Contact ID: ' . $xml->Entry->ContactID . "\n" .
  'Received On: ' . $xml->Entry->ReceivedOn . "\n\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/123?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Message ID : ' . $json->Entry->ID . "\n" .
  'Phone Number: ' . $json->Entry->PhoneNumber . "\n" .
  'Subject: ' . $json->Entry->Subject . "\n" .
  'Message: ' . $json->Entry->Message . "\n" .
  'New: ' . $json->Entry->New . "\n" .
  'Folder ID: ' . $json->Entry->FolderID . "\n" .
  'Contact ID: ' . $json->Entry->ContactID . "\n" .
  'Received On: ' . $json->Entry->ReceivedOn . "\n\n";
}

?>

Back to table of contents

Move Message(s) To A Folder

Moves an incoming text message in your Ez Texting Inbox to a specified folder. Note: You may include multiple Message IDs to move multiple messages to same folder in a single API call.

Code Samples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'ID'        => 12,
  'FolderID'  => 47
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/?format=xml&_method=move-to-folder');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'ID'        => array(12, 13),
  'FolderID'  => 57
  );

$curl = curl_init('https://app.eztexting.com/incoming-messages/?format=json&_method=move-to-folder');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Create An Inbox Folder

Create a Folder in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  'Name'     => 'Customers'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Folder ID : ' . $xml->Entry->ID . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  'Name'     => 'Customers'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Folder ID : ' . $json->Entry->ID . "\n";
}

?>

Back to table of contents

Update An Inbox Folder

Update the name of a Folder in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  'Name'     => 'Customers'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if (!empty($response)) {
  $xml = new SimpleXMLElement($response);

  if ('Failure' == $xml->Status) {
    $errors = array();
    foreach ($xml->Errors->children() as $error) {
      $errors[] = (string)$error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ', $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User' => 'winnie',
  'Password' => 'the-pooh',
  'Name' => 'Customers'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if (!empty($response)) {
  $json = json_decode($response);
  $json = $json->Response;

  if ('Failure' == $json->Status) {
    $errors = array();
    if (!empty($json->Errors)) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ', $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Delete An Inbox Folder

Delete a Folder in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=xml&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=json&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Get All Inbox Folders

Get all Folders in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif (! $xml->Entries->children() ) {
  echo 'Status: ' . $xml->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Total results: ' . $xml->Entries->children()->count() . "\n\n";

  foreach ( $xml->Entries->children() as $folder ) {
    echo 'ID : ' . $folder->ID . "\n" .
    'Name: ' . $folder->Name  . "\n";
  }
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif ( empty($json->Entries) ) {
  echo 'Status: ' . $json->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Total results: ' . count($json->Entries) . "\n\n";

  foreach ( $json->Entries as $folder ) {
    echo 'ID : ' . $folder->ID . "\n" .
    'Name: ' . $folder->Name . "\n\n";
  }
}

?>

Back to table of contents

Get One Inbox Folder

Get a single folder in your Ez Texting Inbox

Code Samples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Folder Name: ' . $xml->Entry->Name . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/messages-folders/123?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Folder Name: ' . $json->Entry->Name . "\n";
}

?>

Back to table of contents

Check Keyword Availability

Check whether a Keyword is available to rent on Ez Texting's short code. Please note, we will check availability for the country your account is set to.

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  'Keyword'  => 'honey'
  );

$curl = curl_init('https://app.eztexting.com/keywords/new?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Keyword: ' . $xml->Entry->Keyword . "\n" .
  'Availability: ' . $xml->Entry->Available . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  'Keyword'  => 'honey'
  );

$curl = curl_init('https://app.eztexting.com/keywords/new?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Keyword: ' . $json->Entry->Keyword . "\n" .
  'Availability: ' . (int) $json->Entry->Available . "\n";
}

?>              

Back to table of contents

Rent Keyword

Rents a Keyword for use on Ez Texting's short code in the country your account is set to send messages to. You may rent a Keyword using a credit card you have stored in your Ez Texting account, or you may pass credit card details when you call the API.

Code Samples - Stored Card

PHP - XML

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'Keyword'          => 'honey',
  'StoredCreditCard' => '1111'
  );

$curl = curl_init('https://app.eztexting.com/keywords?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->ContactGroupIDs->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Keyword ID: ' . $xml->Entry->ID . "\n" .
  'Keyword: ' . $xml->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $xml->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $xml->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $xml->Entry->JoinMessage . "\n" .
  'Forward email: ' . $xml->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $xml->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'Keyword'          => 'honey',
  'StoredCreditCard' => '1111'
  );

$curl = curl_init('https://app.eztexting.com/keywords?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Keyword ID: ' . $json->Entry->ID . "\n" .
  'Keyword: ' . $json->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $json->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $json->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $json->Entry->JoinMessage . "\n" .
  'Forward email: ' . $json->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $json->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $json->Entry->ContactGroupIDs) . "\n";
}

?>

Code Samples - Non-Stored Card

PHP - XML

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'Keyword'          => 'honey',
  'FirstName'        => 'Winnie',
  'LastName'         => 'The Pooh',
  'Street'           => 'Hollow tree, under the name of Mr. Sanders',
  'City'             => 'Hundred Acre Woods',
  'State'            => 'New York',
  'Zip'              => '12345',
  'Country'          => 'US',
  'CreditCardTypeID' => 'Visa',
  'Number'           => '4111111111111111',
  'SecurityCode'     => '123',
  'ExpirationMonth'  => '10',
  'ExpirationYear'   => '2017'
  );

$curl = curl_init('https://app.eztexting.com/keywords?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->ContactGroupIDs->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Keyword ID: ' . $xml->Entry->ID . "\n" .
  'Keyword: ' . $xml->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $xml->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $xml->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $xml->Entry->JoinMessage . "\n" .
  'Forward email: ' . $xml->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $xml->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'Keyword'          => 'honey',
  'FirstName'        => 'Winnie',
  'LastName'         => 'The Pooh',
  'Street'           => 'Hollow tree, under the name of Mr. Sanders',
  'City'             => 'Hundred Acre Woods',
  'State'            => 'New York',
  'Zip'              => '12345',
  'Country'          => 'US',
  'CreditCardTypeID' => 'Visa',
  'Number'           => '4111111111111111',
  'SecurityCode'     => '123',
  'ExpirationMonth'  => '10',
  'ExpirationYear'   => '2017'
  );

$curl = curl_init('https://app.eztexting.com/keywords?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Keyword ID: ' . $json->Entry->ID . "\n" .
  'Keyword: ' . $json->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $json->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $json->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $json->Entry->JoinMessage . "\n" .
  'Forward email: ' . $json->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $json->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $json->Entry->ContactGroupIDs) . "\n";
}

?>

Back to table of contents

Setup A Keyword

Configures an active Keyword for use on Ez Texting's short code in the country your account is set to send messages to.

Code Samples

PHP - XML

<?php

$data = array(
  'User'              => 'winnie',
  'Password'          => 'the-pooh',
  'EnableDoubleOptIn' => true,
  'ConfirmMessage'    => 'Reply Y to join our sweetest list',
  'JoinMessage'       => 'The only reason for being a bee that I know of, is to make honey. And the only reason for making honey, is so as I can eat it.',
  'ForwardEmail'      => 'honey@bear-alliance.co.uk',
  'ForwardUrl'        => 'http://bear-alliance.co.uk/honey-donations/',
  'ContactGroupIDs'   => array('honey lovers')
  );

$curl = curl_init('https://app.eztexting.com/keywords/honey?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->ContactGroupIDs->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Keyword ID: ' . $xml->Entry->ID . "\n" .
  'Keyword: ' . $xml->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $xml->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $xml->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $xml->Entry->JoinMessage . "\n" .
  'Forward email: ' . $xml->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $xml->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'              => 'winnie',
  'Password'          => 'the-pooh',
  'EnableDoubleOptIn' => true,
  'ConfirmMessage'    => 'Reply Y to join our sweetest list',
  'JoinMessage'       => 'The only reason for being a bee that I know of, is to make honey. And the only reason for making honey, is so as I can eat it.',
  'ForwardEmail'      => 'honey@bear-alliance.co.uk',
  'ForwardUrl'        => 'http://bear-alliance.co.uk/honey-donations/',
  'ContactGroupIDs'   => array('honey lovers')
  );

$curl = curl_init('https://app.eztexting.com/keywords/honey?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Keyword ID: ' . $json->Entry->ID . "\n" .
  'Keyword: ' . $json->Entry->Keyword . "\n" .
  'Is double opt-in enabled: ' . (int) $json->Entry->EnableDoubleOptIn . "\n" .
  'Confirm message: ' . $json->Entry->ConfirmMessage . "\n" .
  'Join message: ' . $json->Entry->JoinMessage . "\n" .
  'Forward email: ' . $json->Entry->ForwardEmail . "\n" .
  'Forward url: ' . $json->Entry->ForwardUrl . "\n" .
  'Groups: ' . implode(', ' , $json->Entry->ContactGroupIDs) . "\n";
}

?>

Back to table of contents

Cancel A Keyword

Cancels an active Keyword on Ez Texting's short code in the country your account is set to send messages to.

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/keywords/honey?format=xml&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/keywords/honey?format=json&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Check Credit Balance

Checks credit balances on your account.

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits/get?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Plan credits: ' . $xml->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $xml->Entry->AnytimeCredits . "\n" .
  'Total: ' . $xml->Entry->TotalCredits . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits/get?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Plan credits: ' . $json->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $json->Entry->AnytimeCredits . "\n" .
  'Total: ' . $json->Entry->TotalCredits . "\n";
}

?>

Back to table of contents

Buy Credits

Buys more credits for your account. You may purchase credits using a credit card you have stored in your Ez Texting account, or you may pass credit card details when you call the API.

Code Samples - Stored Card

PHP - XML

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'NumberOfCredits'  => '1000',
  'CouponCode'       => 'honey2011',
  'StoredCreditCard' => '1111'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Credits purchased: ' . $xml->Entry->BoughtCredits . "\n" .
  'Amount charged, $: ' . sprintf("%01.2f", $xml->Entry->Amount) . "\n" .
  'Discount, $: ' . sprintf("%01.2f", $xml->Entry->Discount) . "\n" .
  'Plan credits: ' . $xml->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $xml->Entry->AnytimeCredits . "\n" .
  'Total: ' . $xml->Entry->TotalCredits . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'NumberOfCredits'  => '1000',
  'CouponCode'       => 'honey2011',
  'StoredCreditCard' => '1111'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Credits purchased: ' . $json->Entry->BoughtCredits . "\n" .
  'Amount charged, $: ' . sprintf("%01.2f", $json->Entry->Amount) . "\n" .
  'Discount, $: ' . sprintf("%01.2f", $json->Entry->Discount) . "\n" .
  'Plan credits: ' . $json->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $json->Entry->AnytimeCredits . "\n" .
  'Total: ' . $json->Entry->TotalCredits . "\n";
}

?>

Code Samples - Non-Stored Card

PHP - XML

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'NumberOfCredits'  => '1000',
  'CouponCode'       => 'honey2011',
  'FirstName'        => 'Winnie',
  'LastName'         => 'The Pooh',
  'Street'           => 'Hollow tree, under the name of Mr. Sanders',
  'City'             => 'Hundred Acre Woods',
  'State'            => 'New York',
  'Zip'              => '12345',
  'Country'          => 'US',
  'CreditCardTypeID' => 'Visa',
  'Number'           => '4111111111111111',
  'SecurityCode'     => '123',
  'ExpirationMonth'  => '10',
  'ExpirationYear'   => '2017'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Credits purchased: ' . $xml->Entry->BoughtCredits . "\n" .
  'Amount charged, $: ' . sprintf("%01.2f", $xml->Entry->Amount) . "\n" .
  'Discount, $: ' . sprintf("%01.2f", $xml->Entry->Discount) . "\n" .
  'Plan credits: ' . $xml->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $xml->Entry->AnytimeCredits . "\n" .
  'Total: ' . $xml->Entry->TotalCredits . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'             => 'winnie',
  'Password'         => 'the-pooh',
  'NumberOfCredits'  => '1000',
  'CouponCode'       => 'honey2011',
  'FirstName'        => 'Winnie',
  'LastName'         => 'The Pooh',
  'Street'           => 'Hollow tree, under the name of Mr. Sanders',
  'City'             => 'Hundred Acre Woods',
  'State'            => 'New York',
  'Zip'              => '12345',
  'Country'          => 'US',
  'CreditCardTypeID' => 'Visa',
  'Number'           => '4111111111111111',
  'SecurityCode'     => '123',
  'ExpirationMonth'  => '10',
  'ExpirationYear'   => '2017'
  );

$curl = curl_init('https://app.eztexting.com/billing/credits?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Credits purchased: ' . $json->Entry->BoughtCredits . "\n" .
  'Amount charged, $: ' . sprintf("%01.2f", $json->Entry->Amount) . "\n" .
  'Discount, $: ' . sprintf("%01.2f", $json->Entry->Discount) . "\n" .
  'Plan credits: ' . $json->Entry->PlanCredits . "\n" .
  'Anytime credits: ' . $json->Entry->AnytimeCredits . "\n" .
  'Total: ' . $json->Entry->TotalCredits . "\n";
}

?>

Back to table of contents

Create A Contact

Adds a new Contact to your Ez Texting account.

Code Samples

PHP - XML

<?php

$data = array(
  'User'        => 'winnie',
  'Password'    => 'the-pooh',
  'PhoneNumber' => '2123456785',
  'FirstName'   => 'Piglet',
  'LastName'    => 'P.',
  'Email'       => 'piglet@small-animals-alliance.org',
  'Note'        => 'It is hard to be brave, when you are only a Very Small Animal.',
  'Groups'      => array('Friends', 'Neighbors')
  );

$curl = curl_init('https://app.eztexting.com/contacts?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->Groups->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Contact ID : ' . $xml->Entry->ID . "\n" .
  'Phone Number: ' . $xml->Entry->PhoneNumber . "\n" .
  'First Name: ' . $xml->Entry->FirstName . "\n" .
  'Last Name: ' . $xml->Entry->LastName . "\n" .
  'Email: ' . $xml->Entry->Email . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Source: ' . $xml->Entry->Source . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $xml->Entry->CreatedAt . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'        => 'winnie',
  'Password'    => 'the-pooh',
  'PhoneNumber' => '2123456785',
  'FirstName'   => 'Piglet',
  'LastName'    => 'P.',
  'Email'       => 'piglet@small-animals-alliance.org',
  'Note'        => 'It is hard to be brave, when you are only a Very Small Animal.',
  'Groups'      => array('Friends', 'Neighbors')
  );

$curl = curl_init('https://app.eztexting.com/contacts?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  if ( !empty($json->Entry->Groups) ) {
    $groups = $json->Entry->Groups;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Contact ID : ' . $json->Entry->ID . "\n" .
  'Phone Number: ' . $json->Entry->PhoneNumber . "\n" .
  'First Name: ' . $json->Entry->FirstName . "\n" .
  'Last Name: ' . $json->Entry->LastName . "\n" .
  'Email: ' . $json->Entry->Email . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Source: ' . $json->Entry->Source . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $json->Entry->CreatedAt . "\n";
}

?>

Back to table of contents

Update A Contact

Update a Contact in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'        => 'winnie',
  'Password'    => 'the-pooh',
  'PhoneNumber' => '2123456785',
  'FirstName'   => 'Piglet',
  'LastName'    => 'P.',
  'Email'       => 'piglet@small-animals-alliance.org',
  'Note'        => 'It is hard to be brave, when you are only a Very Small Animal.',
  'Groups'      => array('Friends', 'Neighbors')
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b5720734fada368000000?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->Groups->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Contact ID : ' . $xml->Entry->ID . "\n" .
  'Phone Number: ' . $xml->Entry->PhoneNumber . "\n" .
  'First Name: ' . $xml->Entry->FirstName . "\n" .
  'Last Name: ' . $xml->Entry->LastName . "\n" .
  'Email: ' . $xml->Entry->Email . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Source: ' . $xml->Entry->Source . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $xml->Entry->CreatedAt . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'        => 'winnie',
  'Password'    => 'the-pooh',
  'PhoneNumber' => '2123456785',
  'FirstName'   => 'Piglet',
  'LastName'    => 'P.',
  'Email'       => 'piglet@small-animals-alliance.org',
  'Note'        => 'It is hard to be brave, when you are only a Very Small Animal.',
  'Groups'      => array('Friends', 'Neighbors')
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b5720734fada368000000?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  if ( !empty($json->Entry->Groups) ) {
    $groups = $json->Entry->Groups;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Contact ID : ' . $json->Entry->ID . "\n" .
  'Phone Number: ' . $json->Entry->PhoneNumber . "\n" .
  'First Name: ' . $json->Entry->FirstName . "\n" .
  'Last Name: ' . $json->Entry->LastName . "\n" .
  'Email: ' . $json->Entry->Email . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Source: ' . $json->Entry->Source . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $json->Entry->CreatedAt . "\n";
}

?>

Back to table of contents

Delete A Contact

Delete a Contact in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b52fd734fada068000000?format=xml&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b52fd734fada068000000?format=json&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Get All Contacts

Return a list of all Contacts in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'source'        => 'upload',
  'optout'        => false,
  'group'         => 'Honey Lovers',
  'sortBy'        => 'PhoneNumber',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/contacts?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif (! $xml->Entries->children() ) {
  echo 'Status: ' . $xml->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Total results: ' . $xml->Entries->children()->count() . "\n\n";

  foreach ( $xml->Entries->children() as $contact ) {
    $groups = array();
    foreach( $contact->Groups->children() as $group ) {
      $groups[] = (string) $group;
    }

    echo 'Contact ID : ' . $contact->ID . "\n" .
    'Phone Number: ' . $contact->PhoneNumber . "\n" .
    'First Name: ' . $contact->FirstName . "\n" .
    'Last Name: ' . $contact->LastName . "\n" .
    'Email: ' . $contact->Email . "\n" .
    'Note: ' . $contact->Note . "\n" .
    'Source: ' . $contact->Source . "\n" .
    'Opted Out: ' . ($contact->OptOut ? 'true' : 'false') . "\n" .
    'Groups: ' . implode(', ' , $groups) . "\n" .
    'CreatedAt: ' . $contact->CreatedAt . "\n\n";
  }
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'source'        => 'upload',
  'optout'        => false,
  'group'         => 'Honey Lovers',
  'sortBy'        => 'PhoneNumber',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/contacts?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif ( empty($json->Entries) ) {
  echo 'Status: ' . $json->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Total results: ' . count($json->Entries) . "\n\n";

  foreach ( $json->Entries as $contact ) {
    $groups = array();
    if ( !empty($contact->Groups) ) {
      $groups = $contact->Groups;
    }

    echo 'Contact ID : ' . $contact->ID . "\n" .
    'Phone Number: ' . $contact->PhoneNumber . "\n" .
    'First Name: ' . $contact->FirstName . "\n" .
    'Last Name: ' . $contact->LastName . "\n" .
    'Email: ' . $contact->Email . "\n" .
    'Note: ' . $contact->Note . "\n" .
    'Source: ' . $contact->Source . "\n" .
    'Opted Out: ' . ($contact->OptOut ? 'true' : 'false') . "\n" .
    'Groups: ' . implode(', ' , $groups) . "\n" .
    'CreatedAt: ' . $contact->CreatedAt . "\n\n";
  }
}

?>

Back to table of contents

Get A Contact

Return a single Contact in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b52fd734fada068000000?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  foreach( $xml->Entry->Groups->children() as $group ) {
    $groups[] = (string) $group;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Contact ID : ' . $xml->Entry->ID . "\n" .
  'Phone Number: ' . $xml->Entry->PhoneNumber . "\n" .
  'First Name: ' . $xml->Entry->FirstName . "\n" .
  'Last Name: ' . $xml->Entry->LastName . "\n" .
  'Email: ' . $xml->Entry->Email . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Source: ' . $xml->Entry->Source . "\n" .
  'Opted Out: ' . ($xml->Entry->OptOut ? 'true' : 'false') . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $xml->Entry->CreatedAt . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/contacts/4f0b52fd734fada068000000?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  $groups = array();
  if ( !empty($json->Entry->Groups) ) {
    $groups = $json->Entry->Groups;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Contact ID : ' . $json->Entry->ID . "\n" .
  'Phone Number: ' . $json->Entry->PhoneNumber . "\n" .
  'First Name: ' . $json->Entry->FirstName . "\n" .
  'Last Name: ' . $json->Entry->LastName . "\n" .
  'Email: ' . $json->Entry->Email . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Source: ' . $json->Entry->Source . "\n" .
  'Opted Out: ' . ($json->Entry->OptOut ? 'true' : 'false') . "\n" .
  'Groups: ' . implode(', ' , $groups) . "\n" .
  'CreatedAt: ' . $json->Entry->CreatedAt . "\n";
}

?>

Back to table of contents

Create A Group

Adds a new Group to your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'Name'      => 'Tubby Bears',
  'Note'      => 'A bear, however hard he tries, grows tubby without exercise',
  );

$curl = curl_init('https://app.eztexting.com/groups?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Group ID : ' . $xml->Entry->ID . "\n" .
  'Name: ' . $xml->Entry->Name . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Number of Contacts: ' . $xml->Entry->ContactCount . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'Name'      => 'Tubby Bears',
  'Note'      => 'A bear, however hard he tries, grows tubby without exercise',
  );

$curl = curl_init('https://app.eztexting.com/groups?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Group ID : ' . $json->Entry->ID . "\n" .
  'Name: ' . $json->Entry->Name . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Number of Contacts: ' . $json->Entry->ContactCount . "\n";
}

?>

Back to table of contents

Update A Group

Update a Group in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'Name'      => 'Tubby Bears',
  'Note'      => 'A bear, however hard he tries, grows tubby without exercise',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=xml');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Group ID : ' . $xml->Entry->ID . "\n" .
  'Name: ' . $xml->Entry->Name . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Number of Contacts: ' . $xml->Entry->ContactCount . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  'Name'      => 'Tubby Bears',
  'Note'      => 'A bear, however hard he tries, grows tubby without exercise',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=json');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Group ID : ' . $json->Entry->ID . "\n" .
  'Name: ' . $json->Entry->Name . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Number of Contacts: ' . $json->Entry->ContactCount . "\n";
}

?>

Back to table of contents

Delete A Group

Delete a Group in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=xml&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $xml = new SimpleXMLElement($response);
  if ( 'Failure' == $xml->Status ) {
    $errors = array();
    foreach( $xml->Errors->children() as $error ) {
      $errors[] = (string) $error;
    }

    echo 'Status: ' . $xml->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=json&_method=DELETE');
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

if ( !empty($response) ) {
  $json = json_decode($response);
  $json = $json->Response;

  if ( 'Failure' == $json->Status ) {
    $errors = array();
    if ( !empty($json->Errors) ) {
      $errors = $json->Errors;
    }

    echo 'Status: ' . $json->Status . "\n" .
    'Errors: ' . implode(', ' , $errors) . "\n";
  }
} else {
  echo 'Status: Success' . "\n";
}

?>

Back to table of contents

Get All Groups

Return a list of all Groups in your Ez Texting account.

Code Examples

PHP - XML

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'sortBy'        => 'Name',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/groups?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif (! $xml->Entries->children() ) {
  echo 'Status: ' . $xml->Status . "\n" .
  'Search has returned no groups' . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Total results: ' . $xml->Entries->children()->count() . "\n\n";

  foreach ( $xml->Entries->children() as $group ) {
    echo 'Group ID : ' . $group->ID . "\n" .
    'Name: ' . $group->Name . "\n" .
    'Note: ' . $group->Note . "\n" .
    'Number of Contacts: ' . $group->ContactCount . "\n\n";
  }
}

?>

PHP - JSON

<?php

$data = array(
  'User'          => 'winnie',
  'Password'      => 'the-pooh',
  'sortBy'        => 'Name',
  'sortDir'       => 'asc',
  'itemsPerPage'  => '10',
  'page'          => '3',
  );

$curl = curl_init('https://app.eztexting.com/groups?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} elseif ( empty($json->Entries) ) {
  echo 'Status: ' . $json->Status . "\n" .
  'Search has returned no results' . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Total results: ' . count($json->Entries) . "\n\n";

  foreach ( $json->Entries as $group ) {
    echo 'Group ID : ' . $group->ID . "\n" .
    'Name: ' . $group->Name . "\n" .
    'Note: ' . $group->Note . "\n" .
    'Number of Contacts: ' . $group->ContactCount . "\n\n";
  }
}

?>

Back to table of contents

Get A Group

Return a single Group in your Ez Texting account.

Code Samples

PHP - XML

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Group ID : ' . $xml->Entry->ID . "\n" .
  'Name: ' . $xml->Entry->Name . "\n" .
  'Note: ' . $xml->Entry->Note . "\n" .
  'Number of Contacts: ' . $xml->Entry->ContactCount . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'      => 'winnie',
  'Password'  => 'the-pooh',
  );

$curl = curl_init('https://app.eztexting.com/groups/162467?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Group ID : ' . $json->Entry->ID . "\n" .
  'Name: ' . $json->Entry->Name . "\n" .
  'Note: ' . $json->Entry->Note . "\n" .
  'Number of Contacts: ' . $json->Entry->ContactCount . "\n";
}

?>

Back to table of contents

Carrier Lookup

Returns the wireless carrier of a valid mobile phone number (US & Canada)

Code Samples

PHP - XML

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/sending/phone-numbers/2345678910?format=xml&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$xml = new SimpleXMLElement($response);
if ( 'Failure' == $xml->Status ) {
  $errors = array();
  foreach( $xml->Errors->children() as $error ) {
    $errors[] = (string) $error;
  }

  echo 'Status: ' . $xml->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $xml->Status . "\n" .
  'Phone number: ' . $xml->Entry->PhoneNumber . "\n" .
  'CarrierName: ' . $xml->Entry->CarrierName . "\n";
}

?>

PHP - JSON

<?php

$data = array(
  'User'     => 'winnie',
  'Password' => 'the-pooh'
  );

$curl = curl_init('https://app.eztexting.com/sending/phone-numbers/2345678910?format=json&' . http_build_query($data));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
// If you experience SSL issues, perhaps due to an outdated SSL cert
// on your own server, try uncommenting the line below
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($curl);
curl_close($curl);

$json = json_decode($response);
$json = $json->Response;

if ( 'Failure' == $json->Status ) {
  $errors = array();
  if ( !empty($json->Errors) ) {
    $errors = $json->Errors;
  }

  echo 'Status: ' . $json->Status . "\n" .
  'Errors: ' . implode(', ' , $errors) . "\n";
} else {
  echo 'Status: ' . $json->Status . "\n" .
  'Phone number: ' . $json->Entry->PhoneNumber . "\n" .
  'CarrierName: ' . $json->Entry->CarrierName . "\n";
}

?>