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. Open the file → includes/config.php
  2. Set the compulsory settings (installation URL and MySQL credentials)
  3. Set the optional settings if you need (MySQL port and character set)

Step 2: Upload Sendy

  1. Upload all files to your server.
  2. Make sure the .htaccess file (from the main directory), is uploaded to your server as well (may be hidden if you're using a Mac).

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. If you uploaded Sendy to http://yourdomain/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 for PHP 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) & get your Access Credentials

In order to use Amazon SES, you need to signup for an Amazon Web Services (AWS) account.

  1. Visit Amazon Web Services (AWS) and sign up for an AWS account.

  2. Once signed up, you need to retrieve your 'Access Credentials' from your AWS account. These are the set of "keys" to allow Sendy to send emails via your Amazon SES account. Start by creating an IAM (Identity and Access Management) user in your IAM console.

    Click the Create New Users button:

  3. Type "sendy" in the first field, then click the Create button.

  4. Copy your Access Key ID and Secret Access Key from the screen that follows and paste it in Sendy's Settings > Amazon Web Services Credentials. Save your Settings in Sendy then return to your IAM console to close the credentials window.

  5. IMPORTANT: Do not skip the remaining steps, otherwise your quota will show up as zeros in Sendy.

    You now need to "Attach User Policy" to your Access Credentials to allow Sendy full SES access.

    In your IAM console, click on "sendy" then click the "Permissions" tab in the screen that follows.

    Then click the Attach User Policy button.

  6. Scroll down and find Amazon SES Full Access, then click the Select button. Then click Attach Policy in the screen that follows.

  7. You've successfully created your Access Credentials, saved it in Sendy and allowed Sendy full access to Amazon SES.

Step 6. Setup Amazon Simple Email Service (SES)

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 and request for production access.

  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).

  3. Now, you'll need to request for production access to be able to send to and from any email address as well as raise your sending limits from 200 to 10,000 emails per day.

    If your subscriber base is larger than 10k, request for extended access after receiving production access to further increase your limit.

Step 7. Setup bounce handling

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 and click Create New Topic.

    Name it bounces and leave the Display Name blank.

  2. After creating the topic bounces, create a new subscription.

  3. Select HTTP protocol.

  4. 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 Subscribe button. Sendy will instantly confirm the subscription.

  5. 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.

  6. Under 'Notifications', click Edit Configuration.

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

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

Step 8. Setup complaints handling

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.

  2. After creating the topic complaints, create a new subscription.

  3. Select HTTP protocol.

  4. 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 Subscribe button. Sendy will instantly confirm the subscription.

  5. 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.

  6. Under 'Notifications', click Edit Configuration.

  7. 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).

  8. Repeat #5 to #7 for every email and/or domain you've previously verified in your SES console.
  9. 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 Widgets Inc. And, you have several products under it. These several "child" products are what we refer to as 'brands'. With brands, you can also setup accounts for each of your clients. Optionally send them a password to login and send newsletters on their own at a price you set.

For every new email you wish to use as the sending email address, don't forget to verify it (step 6) as well as register bounces (step 7.5 to 7.7) and complaints (step 8.5 to 8.7) for it.

If you've already verified the sending domain in your Amazon SES console and setup bounces & complaints for it, you don't have to do the same for each email you want to use as the sending email address.

Have fun!



Troubleshooting & Support

Please visit the troubleshooting page if you need any help.



Sendy API

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



Translate Sendy

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

Join our newsletter