Email Delivery Simplified

The only requirement is having programming skills. We designed SenderSuite to be an easy-to-integrate service. A programmer with moderate skills can integrate SenderSuite delivery gateway to his/her project within appr. 10-15 minutes.

SenderSuite API uses the easiest API protocol called HTTP REST. This means that with a basic HTTP connection to our API, you can delivery your emails.

We monitor every single email and suspend accounts which violate our terms of use and anti-spam policies.

We monitor bounced email addresses for you and filter them from your lists. Handling bounced email addresses plays a big role and better email delivery and we will do it for you.

Like bounce handling, spam complaints are also handled by our service. Once a spam complaint is received for one of your delivered emails, we will automatically detect it and don't let you to send any more emails to the spam complaint owner email. This will ensure you to comply with CAN-SPAM laws as well as our strict anti-spam policy.

Do you need assistance? We will be happy to help and answer your questions. After logging to your account, just click the "Support" link on the top right menu and open a support ticket. We will get back to you as fast as possible.

SenderSuite uses the HTTP REST method to accept connections and data from your applications. Connecting to our delivery API is easy and will take a few minutes to perform.

API Connection URL

You will need to use the following URL to pass parameters to SenderSuite API:

http://sendersuite.com/api/

API Connection Parameters

Following parameters need to be passed in during API connection:

• APIKey (required)
  This is the API key you have created in your SenderSuite account.
• FromName
  The sender name. Avoid passing an email address for this field.
• From (required)
  The sender email address. You should register the sender email address in your SenderSuite in order to deliver emails.
• ReplyToName
  The name you wish to display once recipient hits the "Reply" button.
• ReplyTo
  The email address you wish to receive recipient replies. If this not passed in, recipient replies will be sent to from email address.
• To (required)
  Recipient email address.
• Subject (required)
  Subject of the email.
• HTMLBody (required)
  HTML content for the email body. If you wish to send a text only email, leave this field empty and pass in the TextBody field.
• TextBody (required)
  Text content for the email body. If you wish to send an HTML email with alternate content, set this field addition to HTMLBody field.
• CustomArgs (optional)
  You can pass your own parameters in JSON format. These parameters will be sent back to your hooks once bounce or spam complaint is detected. Example: {"UserID":10,"CustomID1":20,"Name":"Cem"}

API Response Reference

SenderSuite returns the response in JSON format.

If your request data is accepted by the API, you will get the following success message in JSON format:

{"Success":true}

If any error occurs, the following response data will be sent to you:

{"Success":false, "ErrorCode":, "ErrorFields":}

One of the following success/error codes will be returned upon successful API connection:

• 100
  Some required fields are not received during API connection. Check ErrorFields for list of fields.
• 101
  Invalid API key. Be sure that you have created an API key in your account and passed it correctly.
• 102
  Invalid user information. Your API key is incorrect or your account is suspended.
• 103
  You don't have enough delivery credits. Please login to your SenderSuite account and purchase delivery credits.
• 104
  Sender email address is not registered. Login to your SenderSuite account and register the "From" email address.
• 105
  "To" and/or "Reply-To" email addresses are invalid.
• 106
  Recipient email address is suspended for the sender user.
• 107
  Recipient email address is in Spam list or Hard Bounce list.
• 108
  Account is not provisioned. API connections and email delivery will not be processed until provisioned.

You can get benefit of ready-to-use libraries for different platforms:

PHP 5

PHP5 SenderSuite API class can be downloaded from GitHub repository.

PHP 5 CodeIgniter Framework Library

PHP5 CodeIgniter framework SenderSuite API class can be downloaded from GitHub repository.

PHP Laravel Framework Bundle

You can learn more about Laravel framework bundle for SenderSuite from SenderSuite Laravel Bundle page.

.NET Library

.NET library can be downloaded from GitHub repository.

You can find some examples for connecting to our API below:

CURL Example

This is a basic API connection via curl example which can be tested on *nix and Mac platforms easily:

curl http://sendersuite.com/api/ -d "APIKey=<your_api_key>&From=<from_name>&From=<from_email>&
To=<recipient_email_address>&Subject=Test Subject&HTMLBody=<strong>This is a test</strong>&TextBody=This is the text part"

You will get the following response data if the API accepts your request data:

{"Success":true}

PHP Example

PHP CodeIgniter Framework Library

You can find the library module for the popular PHP framework CodeIgniter below. Once you download it, unzip and upload "sendersuite.php" to your CodeIgniter applicatoin/libraries directory.

$this->load->library('sendersuite');



$this->sendersuite->SetAPIKey('your_api_key');

$this->sendersuite->SetSender('your@registered_email.com', 'your_name');

$this->sendersuite->SetReplyTo('reply@to_email.com', 'reply_to_name');

$this->sendersuite->SetRecipient('recipient_email_address');

$this->sendersuite->SetMessage('subject', '<strong>html subject</strong>', 'plain subject');

$Result = $this->sendersuite->SendMessage();



if ($Result == false)

	{

	print_r($this->sendersuite->GetErrorInfo());

	exit;

	}

else

	{

	print('Message Sent');

	exit;

	}