Sendy

Got Sendy? Get started.


Setting up Sendy

Installing Sendy is a pretty simple process. Upload the files, create a database, set a few settings and the rest are a matter of clicking around your Amazon Web Services console. The instructions are described in the following easy to follow steps.

If you require installation service, we do provide it for only $79. Simply reply the license email sent to you after purchase.


Step 1. config.php

  1. Download Sendy using the download link in your license email, then unzip it.
  2. In the /includes/ folder, open the file config.php file in any text or code editor
  3. In the file you've just opened, set the APP_PATH (the URL where you've uploaded Sendy) and your MySQL credentials

    Beginner Tip: If you've never created a MySQL database & user before, follow this easy to follow video tutorial or this step by step guide on doing so in cPanel. If your host does not use cPanel, refer to your host's documentation on creating a MySQL database & user.

Step 2: Upload Sendy

Upload Sendy to your server.

Beginner Tip: You can use an FTP app like Cyberduck or the File Manager in your hosting control panel to upload Sendy.

Step 3. Set file permissions of uploads folder

Image, attachment and CSV uploads requires the /uploads/ folder's permission to be set to 777.

Step 4. Install Sendy

  1. Visit your Sendy installation. For example, if you uploaded Sendy to http://yourdomain.com/sendy, visit this link to install.

    Note: If your installation page fails to load, visit http://your_sendy_installation_url/_compatibility.php?i=1 to see which extensions are not installed on your server and request your host to install it.

  2. Your License key is included in the email sent to you after you made your purchase.
  3. You'll be asked to specify your Email and Password. These will be your login credentials for Sendy.
  4. You can fill in your AWS Access Key ID and AWS Secret Access Key later if you have not signed up for Amazon Web Services yet (we'll cover this in the next step).
  5. Click the Install now button to proceed.

Step 5. Sign up for Amazon Web Services (AWS) & create IAM Credentials

  1. Sign up for an Amazon Web Services (AWS) account if you don't have one. Click the Create a new AWS account button while at the login page to sign up.

  2. Once signed up, you're ready to hook up Sendy with your AWS account. To do so, you'd need to create a pair of 'IAM Credentials' for your Sendy installation. Start by visiting your Amazon IAM console, then follow the instructions in the video below:

  3. Once you've created your IAM credentials, copy and paste them into the installation page or your Sendy settings (under Amazon Web Services Credentials). Sendy will now have access to send your emails via Amazon SES as well as setup bounces and complaints handling with Amazon SNS.
  4. Finally, you'll need to request Amazon to increase your SES Sending Limits to get your Amazon SES account out of "sandbox mode". You'll then be able to send to and from any email address as well as raise your daily sending limits from 200 per day to any number you need.

Step 6. Verify emails or domains for sending via Amazon SES Sendy now initiates the verification process right inside the app

IMPORTANT: Before continuing, ensure that the drop down menu at the top right of your SES console displays the same region as what is set in your Sendy main Settings under 'Amazon SES region'.

In order to start sending bulk emails, you need to verify your sending emails OR domains.

  1. Verify your sending email address in your Amazon SES console > Verified Senders > Email Addresses. Say you're going to use yourname@domain.com to send newsletters in Sendy, verify yourname@domain.com in your SES console. Click the Verify a New Email Address button and follow the instructions.

    Tip: If you want to send from any email address belonging to a particular domain without having to verify each email address, verify your sending domain instead (see #2 below).

  2. To verify your sending domain, go to your Amazon SES console > Verified Senders > Domains. Then click the Verify a New Domain button and follow the instructions. By verifying your sending domain, you can send from any email address belonging to this domain without verifying them in #1.

    Note: Do not verify your domain with 'www' prepended to your domain. Eg. if your domain is mydomain.com, verify mydomain.com and not www.mydomain.com unless your emails looks like this name@www.mydomain.com (which is rarely the case).

Step 7. Setup bounce handling Sendy now handles these steps automatically

IMPORTANT: Before continuing, ensure that the drop down menu at the top right of your SNS console displays the same region as what is set in your Sendy main Settings under 'Amazon SES region'.

Amazon SNS is required to track bounces & complaints. If an email bounced, the email address will be flagged in Sendy so that future newsletters won't be sent to them again. To make this possible, here's what you need to do:

  1. Go to your SNS console, click Topics on the left sidebar, then click the Create new topic button.

    Name it bounces and leave the Display name blank, then click the Create topic button.

  2. After creating the topic bounces, click the 'bounces' checkbox then click the Actions button, then click Subscribe to topic.

  3. Now you need to populate the Endpoint field. Let's say you installed Sendy on http://yourdomain/sendy/, your Endpoint will be http://yourdomain/sendy/includes/campaigns/bounces.php. In other words, includes/campaigns/bounces.php should be appended at the end of your installation URL.

    Click the Create subscription button. Sendy will instantly confirm the subscription.

  4. Go to your Amazon SES console > Verified Senders > Email Addresses and click on the email you attempted to verify. If you verified a domain, go to Amazon SES console > Verified Senders > Domains and click on the domain you attempted to verify.

  5. Under 'Notifications', click Edit Configuration.

  6. Under 'SNS Topic Configuration', click the Bounces drop down menu and select bounces (which is what you've created previously in your SNS console).

  7. Repeat #5 to #7 for every email and/or domain you've previously verified in your SES console.
  8. Done! All email bounces will now be tracked and handled when you send emails in Sendy.

Step 8. Setup complaint handling Sendy now handles these steps automatically

IMPORTANT: Before continuing, ensure that the drop down menu at the top right of your SNS console displays the same region as what is set in your Sendy main Settings under 'Amazon SES region'.

If a user marks your email as spam, they will be flagged in Sendy so that future newsletters won't be sent to them again.
The following steps to setup complaints handling are identical to bounce handling in the previous step:

  1. Click Create new topic in your SNS console.

    Name it complaints and leave the Display name blank, then click the Create topic button..

  2. After creating the topic complaints, click the 'complaints' checkbox then click the Actions button, then click Subscribe to topic.

  3. Now you need to populate the Endpoint field. Let's say you installed Sendy on http://yourdomain/sendy/, your Endpoint will be http://yourdomain/sendy/includes/campaigns/complaints.php. In other words, includes/campaigns/complaints.php should be appended at the end of your installation URL.

    Click the Create subscription button. Sendy will instantly confirm the subscription.

  4. Go to your Amazon SES console > Verified Senders > Email Addresses and click on the email you attempted to verify. If you verified a domain, go to Amazon SES console > Verified Senders > Domains and click on the domain you attempted to verify.

  5. Under 'Notifications', click Edit Configuration.

  6. Under 'SNS Topic Configuration', click the Complaints drop down menu, scroll down and select complaints (which is what you've created previously in your SNS console).

  7. Repeat #5 to #7 for every email and/or domain you've previously verified in your SES console.
  8. By now, you should have setup bounces and complaints for every verified email and/or domain.

Enjoy Sendy! What's next?

Congratulations! You're all set up.

Log in to your Sendy installation and start adding your first Brand. What are brands? Let's just say you own this company called Apple Inc and you have several products under it eg. Mac, iPhone, iPad etc. These several "child" products are what we refer to as 'brands'.

Once you've created a brand, you can then create lists, import subscribers, setup autoresponders, perform list segmentation and send email newsletters in each brand.

You can also generate a set of login credentials for each brand, set access privileges, set monthly limits etc and send them to your clients to login and send newsletters on their own at any price you set.

Have fun!


Note: Looking for Steps 6, 7 and 8? You no longer have to set them up manually as Sendy now takes care of those automatically since version 2.1.0 and up. Just update your Sendy installation to the latest version. If you really need to see the old steps, here you go.



Troubleshooting & Support

Please visit the troubleshooting page for help information as well as quick answers to common issues.



Sendy API

View Sendy's API documentation, download example scripts and browse third party resources & integrations.



Translate Sendy

View our documentation on how to translate Sendy into your own language.

Join our newsletter