This guide will walk you through the process of adding a new list of contacts to your account using the Python library.
Required Access Level: ModifyContacts
When using Elastic Email, you send emails to contacts – recipients who receive your emails. Contacts can be grouped by created segments or lists. Segments add contacts automatically when specfied conditions are met, and contacts on lists are managed manually.
Install Python 3.
Install ElasticEmail library.
Eg. run in terminal pip install ElasticEmail
to install from PyPi repository.
Create a new Python file snippet.py
and open it in editor of your preference eg. PyCharm (https://www.jetbrains.com/pycharm/download/)
Put the below code to your file.
Load libraries using below code:
import ElasticEmail
from ElasticEmail.apis.tags import lists_api
from ElasticEmail.model.list_payload import ListPayload
from pprint import pprint
Generate and use your API key (remember to check a required access level).
Defining the host is optional and defaults to https://api.elasticemail.com/v4
configuration = ElasticEmail.Configuration()
configuration.api_key['apikey'] = 'YOUR_API_KEY'
Pass configuration to an api client and make it instance available under api_client
name:
with ElasticEmail.ApiClient(configuration) as api_client:
Create an instance of ListsApi that will be used to create a new list.
api_instance = lists_api.ListsApi(api_client)
Create an object with details about a new list. Only ListName
is required.
You can also define if to allow unsubscription from list and pass an emails array of existing contacts on your account to add them to list during list creation.
Find out more by checking our API's documentation: https://elasticemail.com/developers/api-documentation/rest-api#operation/listsPost
list_payload = ListPayload(
ListName="Best contacts",
AllowUnsubscribe=True,
Emails=[
"johnsmith@domain.com",
],
)
Use try & except block to call lists_post
method from the API to create a list:
try:
api_response = api_instance.lists_post(body = list_payload)
pprint(api_response)
except ElasticEmail.ApiException as e:
print("Exception when calling ListsApi->lists_post: %s\n" % e)
import ElasticEmail
from ElasticEmail.apis.tags import lists_api
from ElasticEmail.model.list_payload import ListPayload
from pprint import pprint
configuration = ElasticEmail.Configuration()
configuration.api_key['apikey'] = 'YOUR_API_KEY'
with ElasticEmail.ApiClient(configuration) as api_client:
api_instance = lists_api.ListsApi(api_client)
list_payload = ListPayload(
ListName="Best contacts",
AllowUnsubscribe=True,
Emails=[
"johnsmith@domain.com",
],
)
try:
api_response = api_instance.lists_post(body = list_payload)
pprint(api_response)
except ElasticEmail.ApiException as e:
print("Exception when calling ListsApi->lists_post: %s\n" % e)
python3 snippet.py