Our library is now compatible with python 3.7 . Please use: https://github.com/sendinblue/APIv3-python-library/tree/v6.1.0
SendinBlue's API exposes the entire SendinBlue features via a standardized programmatic interface. Please refer to the full documentation to learn more.
This is the wrapper for the API. It implements all the features of the API v3.
SendinBlue's API matches the OpenAPI v2 definition. The specification can be downloaded here.
This PYTHON package is automatically generated by the Swagger Codegen project and is reviewed and maintained by SendinBlue:
Compatible from Python version 2.7 to 3.5+
If the python package is hosted on Github, you can install directly from Github
pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)
Then import the package:
import sib_api_v3_sdk Install via Setuptools.
python setup.py install --user(or sudo python setup.py install to install the package for all users)
Then import the package:
import sib_api_v3_sdkPlease follow the installation procedure and then run the following:
from __future__ import print_function
import time
import sib_api_v3_sdk
from sib_api_v3_sdk.rest import ApiException
from pprint import pprint
# Configure API key authorization: api-key
configuration = sib_api_v3_sdk.Configuration()
configuration.api_key['api-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: partner-key
configuration = sib_api_v3_sdk.Configuration()
configuration.api_key['partner-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['partner-key'] = 'Bearer'
# create an instance of the API class
api_instance = sib_api_v3_sdk.AccountApi(sib_api_v3_sdk.ApiClient(configuration))
try:
# Get your account information, plan and credits details
api_response = api_instance.get_account()
pprint(api_response)
except ApiException as e:
print("Exception when calling AccountApi->get_account: %s\n" % e)
All URIs are relative to https://api.sendinblue.com/v3
| Class | Method | HTTP request | Description |
|---|---|---|---|
| AccountApi | get_account | GET /account | Get your account information, plan and credits details |
| AttributesApi | create_attribute | POST /contacts/attributes/{attributeCategory}/{attributeName} | Create contact attribute |
| AttributesApi | delete_attribute | DELETE /contacts/attributes/{attributeCategory}/{attributeName} | Delete an attribute |
| AttributesApi | get_attributes | GET /contacts/attributes | List all attributes |
| AttributesApi | update_attribute | PUT /contacts/attributes/{attributeCategory}/{attributeName} | Update contact attribute |
| ContactsApi | add_contact_to_list | POST /contacts/lists/{listId}/contacts/add | Add existing contacts to a list |
| ContactsApi | create_attribute | POST /contacts/attributes/{attributeCategory}/{attributeName} | Create contact attribute |
| ContactsApi | create_contact | POST /contacts | Create a contact |
| ContactsApi | create_doi_contact | POST /contacts/doubleOptinConfirmation | Create a contact to trigger the DOI workflow from a Landing Page form |
| ContactsApi | create_folder | POST /contacts/folders | Create a folder |
| ContactsApi | create_list | POST /contacts/lists | Create a list |
| ContactsApi | delete_attribute | DELETE /contacts/attributes/{attributeCategory}/{attributeName} | Delete an attribute |
| ContactsApi | delete_contact | DELETE /contacts/{email} | Delete a contact |
| ContactsApi | delete_folder | DELETE /contacts/folders/{folderId} | Delete a folder (and all its lists) |
| ContactsApi | delete_list | DELETE /contacts/lists/{listId} | Delete a list |
| ContactsApi | get_attributes | GET /contacts/attributes | List all attributes |
| ContactsApi | get_contact_info | GET /contacts/{email} | Get a contact's details |
| ContactsApi | get_contact_stats | GET /contacts/{email}/campaignStats | Get email campaigns' statistics for a contact |
| ContactsApi | get_contacts | GET /contacts | Get all the contacts |
| ContactsApi | get_contacts_from_list | GET /contacts/lists/{listId}/contacts | Get contacts in a list |
| ContactsApi | get_folder | GET /contacts/folders/{folderId} | Returns a folder's details |
| ContactsApi | get_folder_lists | GET /contacts/folders/{folderId}/lists | Get lists in a folder |
| ContactsApi | get_folders | GET /contacts/folders | Get all folders |
| ContactsApi | get_list | GET /contacts/lists/{listId} | Get a list's details |
| ContactsApi | get_lists | GET /contacts/lists | Get all the lists |
| ContactsApi | import_contacts | POST /contacts/import | Import contacts |
| ContactsApi | remove_contact_from_list | POST /contacts/lists/{listId}/contacts/remove | Delete a contact from a list |
| ContactsApi | request_contact_export | POST /contacts/export | Export contacts |
| ContactsApi | update_attribute | PUT /contacts/attributes/{attributeCategory}/{attributeName} | Update contact attribute |
| ContactsApi | update_contact | PUT /contacts/{email} | Update a contact |
| ContactsApi | update_folder | PUT /contacts/folders/{folderId} | Update a folder |
| ContactsApi | update_list | PUT /contacts/lists/{listId} | Update a list |
| EmailCampaignsApi | create_email_campaign | POST /emailCampaigns | Create an email campaign |
| EmailCampaignsApi | delete_email_campaign | DELETE /emailCampaigns/{campaignId} | Delete an email campaign |
| EmailCampaignsApi | email_export_recipients | POST /emailCampaigns/{campaignId}/exportRecipients | Export the recipients of an email campaign |
| EmailCampaignsApi | get_ab_test_campaign_result | GET /emailCampaigns/{campaignId}/abTestCampaignResult | Get an A/B test email campaign results |
| EmailCampaignsApi | get_email_campaign | GET /emailCampaigns/{campaignId} | Get an email campaign report |
| EmailCampaignsApi | get_email_campaigns | GET /emailCampaigns | Return all your created email campaigns |
| EmailCampaignsApi | get_shared_template_url | GET /emailCampaigns/{campaignId}/sharedUrl | Get a shared template url |
| EmailCampaignsApi | send_email_campaign_now | POST /emailCampaigns/{campaignId}/sendNow | Send an email campaign immediately, based on campaignId |
| EmailCampaignsApi | send_report | POST /emailCampaigns/{campaignId}/sendReport | Send the report of a campaign |
| EmailCampaignsApi | send_test_email | POST /emailCampaigns/{campaignId}/sendTest | Send an email campaign to your test list |
| EmailCampaignsApi | update_campaign_status | PUT /emailCampaigns/{campaignId}/status | Update an email campaign status |
| EmailCampaignsApi | update_email_campaign | PUT /emailCampaigns/{campaignId} | Update an email campaign |
| EmailCampaignsApi | upload_image_to_gallery | POST /emailCampaigns/images | Upload an image to your account's image gallery |
| FoldersApi | create_folder | POST /contacts/folders | Create a folder |
| FoldersApi | delete_folder | DELETE /contacts/folders/{folderId} | Delete a folder (and all its lists) |
| FoldersApi | get_folder | GET /contacts/folders/{folderId} | Returns a folder's details |
| FoldersApi | get_folder_lists | GET /contacts/folders/{folderId}/lists | Get lists in a folder |
| FoldersApi | get_folders | GET /contacts/folders | Get all folders |
| FoldersApi | update_folder | PUT /contacts/folders/{folderId} | Update a folder |
| ListsApi | add_contact_to_list | POST /contacts/lists/{listId}/contacts/add | Add existing contacts to a list |
| ListsApi | create_list | POST /contacts/lists | Create a list |
| ListsApi | delete_list | DELETE /contacts/lists/{listId} | Delete a list |
| ListsApi | get_contacts_from_list | GET /contacts/lists/{listId}/contacts | Get contacts in a list |
| ListsApi | get_folder_lists | GET /contacts/folders/{folderId}/lists | Get lists in a folder |
| ListsApi | get_list | GET /contacts/lists/{listId} | Get a list's details |
| ListsApi | get_lists | GET /contacts/lists | Get all the lists |
| ListsApi | remove_contact_from_list | POST /contacts/lists/{listId}/contacts/remove | Delete a contact from a list |
| ListsApi | update_list | PUT /contacts/lists/{listId} | Update a list |
| ProcessApi | get_process | GET /processes/{processId} | Return the informations for a process |
| ProcessApi | get_processes | GET /processes | Return all the processes for your account |
| ResellerApi | add_credits | POST /reseller/children/{childAuthKey}/credits/add | Add Email and/or SMS credits to a specific child account |
| ResellerApi | associate_ip_to_child | POST /reseller/children/{childAuthKey}/ips/associate | Associate a dedicated IP to the child |
| ResellerApi | create_child_domain | POST /reseller/children/{childAuthKey}/domains | Create a domain for a child account |
| ResellerApi | create_reseller_child | POST /reseller/children | Creates a reseller child |
| ResellerApi | delete_child_domain | DELETE /reseller/children/{childAuthKey}/domains/{domainName} | Delete the sender domain of the reseller child based on the childAuthKey and domainName passed |
| ResellerApi | delete_reseller_child | DELETE /reseller/children/{childAuthKey} | Delete a single reseller child based on the childAuthKey supplied |
| ResellerApi | dissociate_ip_from_child | POST /reseller/children/{childAuthKey}/ips/dissociate | Dissociate a dedicated IP to the child |
| ResellerApi | get_child_account_creation_status | GET /reseller/children/{childAuthKey}/accountCreationStatus | Get the status of a reseller's child account creation, whether it is successfully created (exists) or not based on the childAuthKey supplied |
| ResellerApi | get_child_domains | GET /reseller/children/{childAuthKey}/domains | Get all sender domains for a specific child account |
| ResellerApi | get_child_info | GET /reseller/children/{childAuthKey} | Get a child account's details |
| ResellerApi | get_reseller_childs | GET /reseller/children | Get the list of all children accounts |
| ResellerApi | get_sso_token | GET /reseller/children/{childAuthKey}/auth | Get session token to access Sendinblue (SSO) |
| ResellerApi | remove_credits | POST /reseller/children/{childAuthKey}/credits/remove | Remove Email and/or SMS credits from a specific child account |
| ResellerApi | update_child_account_status | PUT /reseller/children/{childAuthKey}/accountStatus | Update info of reseller's child account status based on the childAuthKey supplied |
| ResellerApi | update_child_domain | PUT /reseller/children/{childAuthKey}/domains/{domainName} | Update the sender domain of reseller's child based on the childAuthKey and domainName passed |
| ResellerApi | update_reseller_child | PUT /reseller/children/{childAuthKey} | Update info of reseller's child based on the childAuthKey supplied |
| SMSCampaignsApi | create_sms_campaign | POST /smsCampaigns | Creates an SMS campaign |
| SMSCampaignsApi | delete_sms_campaign | DELETE /smsCampaigns/{campaignId} | Delete an SMS campaign |
| SMSCampaignsApi | get_sms_campaign | GET /smsCampaigns/{campaignId} | Get an SMS campaign |
| SMSCampaignsApi | get_sms_campaigns | GET /smsCampaigns | Returns the information for all your created SMS campaigns |
| SMSCampaignsApi | request_sms_recipient_export | POST /smsCampaigns/{campaignId}/exportRecipients | Export an SMS campaign's recipients |
| SMSCampaignsApi | send_sms_campaign_now | POST /smsCampaigns/{campaignId}/sendNow | Send your SMS campaign immediately |
| SMSCampaignsApi | send_sms_report | POST /smsCampaigns/{campaignId}/sendReport | Send an SMS campaign's report |
| SMSCampaignsApi | send_test_sms | POST /smsCampaigns/{campaignId}/sendTest | Send a test SMS campaign |
| SMSCampaignsApi | update_sms_campaign | PUT /smsCampaigns/{campaignId} | Update an SMS campaign |
| SMSCampaignsApi | update_sms_campaign_status | PUT /smsCampaigns/{campaignId}/status | Update a campaign's status |
| SMTPApi | create_smtp_template | POST /smtp/templates | Create an email template |
| SMTPApi | delete_hardbounces | POST /smtp/deleteHardbounces | Delete hardbounces |
| SMTPApi | delete_smtp_template | DELETE /smtp/templates/{templateId} | Delete an inactive email template |
| SMTPApi | get_aggregated_smtp_report | GET /smtp/statistics/aggregatedReport | Get your transactional email activity aggregated over a period of time |
| SMTPApi | get_email_event_report | GET /smtp/statistics/events | Get all your transactional email activity (unaggregated events) |
| SMTPApi | get_smtp_report | GET /smtp/statistics/reports | Get your transactional email activity aggregated per day |
| SMTPApi | get_smtp_template | GET /smtp/templates/{templateId} | Returns the template information |
| SMTPApi | get_smtp_templates | GET /smtp/templates | Get the list of email templates |
| SMTPApi | get_transac_blocked_contacts | GET /smtp/blockedContacts | Get the list of blocked or unsubscribed transactional contacts |
| SMTPApi | get_transac_email_content | GET /smtp/emails/{uuid} | Get the personalized content of a sent transactional email |
| SMTPApi | get_transac_emails_list | GET /smtp/emails | Get the list of transactional emails on the basis of allowed filters |
| SMTPApi | send_template | POST /smtp/templates/{templateId}/send | Send a template |
| SMTPApi | send_test_template | POST /smtp/templates/{templateId}/sendTest | Send a template to your test list |
| SMTPApi | send_transac_email | POST /smtp/email | Send a transactional email |
| SMTPApi | smtp_blocked_contacts_email_delete | DELETE /smtp/blockedContacts/{email} | Unblock or resubscribe a transactional contact |
| SMTPApi | smtp_log_message_id_delete | DELETE /smtp/log/{messageId} | Delete an SMTP transactional log |
| SMTPApi | update_smtp_template | PUT /smtp/templates/{templateId} | Update an email template |
| SendersApi | create_sender | POST /senders | Create a new sender |
| SendersApi | delete_sender | DELETE /senders/{senderId} | Delete a sender |
| SendersApi | get_ips | GET /senders/ips | Get all the dedicated IPs for your account |
| SendersApi | get_ips_from_sender | GET /senders/{senderId}/ips | Get all the dedicated IPs for a sender |
| SendersApi | get_senders | GET /senders | Get the list of all your senders |
| SendersApi | update_sender | PUT /senders/{senderId} | Update a sender |
| TransactionalSMSApi | get_sms_events | GET /transactionalSMS/statistics/events | Get all your SMS activity (unaggregated events) |
| TransactionalSMSApi | get_transac_aggregated_sms_report | GET /transactionalSMS/statistics/aggregatedReport | Get your SMS activity aggregated over a period of time |
| TransactionalSMSApi | get_transac_sms_report | GET /transactionalSMS/statistics/reports | Get your SMS activity aggregated per day |
| TransactionalSMSApi | send_transac_sms | POST /transactionalSMS/sms | Send the SMS campaign to a mobile number |
| WebhooksApi | create_webhook | POST /webhooks | Create a webhook |
| WebhooksApi | delete_webhook | DELETE /webhooks/{webhookId} | Delete a webhook |
| WebhooksApi | get_webhook | GET /webhooks/{webhookId} | Get a webhook details |
| WebhooksApi | get_webhooks | GET /webhooks | Get all webhooks |
| WebhooksApi | update_webhook | PUT /webhooks/{webhookId} | Update a webhook |
Be sure to visit the SendinBlue official documentation website for additional information about our API.
If you find a bug, please post the issue on Github.
As always, if you need additional assistance, drop us a note here.
contact@sendinblue.com