sendypy 0.2

Dependencies

• It was written for Python 2.7+ and Python 3.6+

• Depends on the requests module

NOTE:

• Version 0.2 now requires api_key varaible for all API calls. This is a required change to the functionality of Sendy as of version 4.0.4. This is a potentially breaking code change. Please update your code to always provide the API key before upgrading to sendypy v0.2.

• Version 0.1.3b adds the new “title” variable to the create_campaign API call. It effects the default ordering of variables in the call. If you’re upgrading from a previous version please ensure that you account for the new ordering of variables. This new variable was added in Sendy v2.1.2.6

Installation

PIP:

pip install sendypy

Basic Manual Install:

$ python setup.py build
$ sudo python setup.py install

Alternative Install (Manually):

Place sendy directory in your Python path. Either in your Python installs site-packages directory or set your $PYTHONPATH environment variable to include a directory where the impersonate directory lives.

Use

All the variables and response values are described in the Sendy API docs

Usage is simple

from sendy.api import SendyAPI
api = SendyAPI(
     host='https://your-sendy-install.com/sendy/',
     api_key='YOUR_API_KEY',
)

You can also provide the optional debug variable (defaults to False). This will print debug into to stdout when sending a request to your Sendy install.

Subscribe

api.subscribe('list_id_here', 'email@address.com', 'optional first name', custom_field_1='value', custom_field_2='value', ...)

Optional fields

• country: User’s 2 letter country code.

• ipaddress: User’s IP address.

• referrer: The URL where the user signed up from.

• gdpr: If you’re signing up EU users in a GDPR compliant manner.

• hp: Include this ‘honeypot’ field to prevent spambots.

data = {"gdpr": True, "ipaddress": "127.0.0.1", "country": "US"}

api.subscribe(list_id, email, **data)

Unsubscribe

api.unsubscribe('list_id_here', 'email@address.com')

Delete

api.delete('list_id_here', 'email@address.com')

Subscription Status

api.subscription_status('list_id_here', 'email@address.com')

Subscriber Count

api.subscriber_count('list_id_here')

Create Campaign

api.create_campaign(
    from_name='Your Name',
    from_email='Your Sender Email',
    reply_to='Your Reply-to Email',
    title='Your Email Title',
    subject='Your Email Subject',
    plain_text='Plain Text Email Body',
    html_text='HTML Email Body',
    list_ids='list_id_1,list_id_2,list_id_3',
    brand_id='your brand id',
    query_string='Your query string',
    send_campaign=0, #default's to 0, use 1 to send email right away
)

Copyright & Warranty

All documentation, libraries, and sample code are Copyright 2016 Netlandish Inc., Peter Sanchez <petersanchez@gmail.com>. The library and sample code are made available to you under the terms of the BSD license which is contained in the included file, BSD-LICENSE.