Code preference:
Curl
Ruby
Php
Python
Node.js
C#
Java

Release Note: API Changes

Release notes for API changes are available here. You must download our latest API wrappers for updated function calls.

6 February 17

Added

New file format possible values .msg, .pub and .mobi added in attachment_url parameter of create_campaign(), update_campaign(), create_trigger_campaign() and update_trigger_campaign() functions

New file format possible values .msg, .pub and .mobi added in attachment_url parameter of send_transactional_template(), create_template() and update_template() functions


20 January 17

Modified

Modified output of get_user() function
Previous output was not having list_unsubscribed in data.

This field contains array of lists from which a contact unsubscribes. The field is only visible for the client’s with multi unsubscription enabled for their account.


11 January 17

Added

Added client_id field in the get_account() functions output

Added dynamic_list field in the get_lists() and get_list() functions output



9 November 16

Added

A new Marketing webhook possible value delivered in events parameter of functions create_webhook() & update_webhook().


7 November 16

Modified

Modified output of get_attributes() function
Previous output was not having type of calculated_value in data

For the new output, please refer here


Made users input parameter as optional in delete_users_list function, so as to facilitate bulk deletion, i.e. removal of all contacts from the list at once.


17 October 16

Modified

Python API V2.0 Library uses new HTTP module Requests
Click here to download the updated Python library.


14 October 16

Added

A new event type possible value unsubscribed in event parameter of function get_report().


7 October 16

Added

Added utm_campaign parameter in create_campaign() and update_campaign() functions, to customize UTM source value for classic type campaigns. If not used default value taken is campaign name.


22 July 16

Modified

Modified output of get_report() function
Previous output was not having subject and from in data

For the new output, please refer here


13 July 16

Added

Added message_id parameter in get_report() function, to search report with message-id.


27 June 16

Added

Added replyto parameter in send_transactional_template() function to customize Reply To email address in Transactional email (templates).


21 June 16

Modified

Modified output of get_smtp_deatils() function
Previous output was not having marketing_automation_key in data

For the new output, please refer here


16 May 16

Added

Added an optional parameter Request Timeout in each library.

Default timeout value is 30,000 MS ( 30 Secs ), which you can pass as 3rd parameter in Mailin class Object.
Maximum allowed timeout is 60,000 MS ( 60 Secs ).


9 February 16

Replaced

Replaced attachment parameter in create_template and update_template functions with attachment_url parameter.

The parameter is replaced so that absolute url of the attachment can be provided with the template create/update instead of just attachment flag 0/1.


21 January 16

Launched

Converted C Sharp API V2.0 Library to Object-based & updated all C Sharp sample codes.
Click here to download the updated C Sharp library.


3 December 15

Modified

Modified output of get_statistics() function
Previous output was not having unique_opens and unique_clicks in data

For the new output please refer here


26 November 15

Added

Added tags parameter in get_report() function, to search report for existing tags.


30 October 15

Modified

Modified output of send_email() and send_transactional_template() functions
Previous output was not having message-id in data

For the new output of send_email(), please refer here
For the new output of send_transactional_template(), please refer here


8 October 15

Launched

Converted Java API V2.0 Library to Object-based & updated all Java sample codes.
Click here to download the updated Java library.


5 October 15

Deprecated

The total_blacklisted field from the output of get_list(s) & get_folder(s) functions, i.e. the count of blacklisted contacts has been deprecated.


24 September 15

Added

A new file format possible value .ics in attachment parameter of functions send_transactional_template() & send_email().


23 September 15

Launched

Converted Node.js API V2.0 Library to Object-based & updated all Node.js sample codes.
Click here to download the updated Node.js library.


18 September 15

Launched

Converted Python API V2.0 Library to Object-based & updated all Python sample codes.
Click here to download the updated Python library.

Modified

Converted Python Package Index to Object-based for Api version 2.0.
Click here to download the updated Sendinblue PYPI.


15 September 15

Added

Added headers parameter in send_transactional_template() function to send custom headers in Transactional email (templates).


11 September 15

Modified

Converted Ruby Gem Library to Object-based for Api version 2.0.
Click here to download the updated Ruby Gem.

If using older version & further upgraded to latest version 2.2, may face ArgumentError: wrong number of arguments in APIs.
In that case, it is highly recommended to update way of sending input parameters, then you may no longer face this issue.


10 September 15

Modified

Increased the value of page_limit parameter from 500 to 1000 in get_campaigns_v2() function.
Please refer input parameter table here.


3 September 15

Launched

Converted Ruby API V2.0 Library to Object-based & updated all Ruby sample codes.
Click here to download the updated Ruby library.


1 September 15

Launched

Converted PHP API V2.0 Library to Object-based & updated all PHP sample codes.
Click here to download the updated PHP library.


31 August 15

Added

Added inline_image parameter in send_email() function to send inline image/s in the campaign.


6 August 15

Added

Added send_now parameter in create_campaign, update_campaign, create_trigger_campaign(), update_trigger_campaign(), create_sms_campaign() and update_sms_campaign() functions to send now the campaign.


31 July 15

Discarded

Removed open_rate_percentage and click_rate_percentage fields from the output of get_list(s) & get_folder(s) functions

For the new output of get_list(s), please refer here
For the new output of get_folder(s), please refer here


20 July 15

Discarded

Removed sender_email parameter from update_sender function


15 July 15

Added

Added mirror_active parameter in create_campaign, update_campaign, create_trigger_campaign() and update_trigger_campaign() functions to activate/ deactivate mirror links.


10 July 15

Modified

Modified output of get_user() function
Previous output was not having transactional_attributes in data

For the new output, please refer here


7 July 15

Modified

Modified output of get_campaign_v2() & get_campaigns_v2() functions
Previous output in ‘stats_by_domain’ key was not having unique_views, unique_clicks & soft_bounces in data

For the new output, please refer here


16 June 15

Added

Added body parameter in import_users() function to import data with whole csv content.


8 June 15

Added

A new Marketing webhook possible value list_addition in events parameter of functions create_webhook() & update_webhook().
Once a user is added successfully to the list, in notify_url, we are sending the content using POST method.
Example: {“event”:”list_addition”,”email”:”example@@example.ne”,”id”:2,”list_id”:[5,6],”date”:”2015-06-03 12:31:38″,”ts”:1433334698}


27 May 15

Added

Added list_parent parameter in get_lists() function to fetch all lists belonging to this folder.


25 May 15

Added

Added timestamp parameter in display_list_users() function to fetch modified user records on basis of the timestamp.

Modified

Modified output of display_list_users() function
Previous output was not having last_modified in data

For the new output of display_list_users(), please refer here


7 April 15

Modified

Modified output of get_user() function
Previous output was not having unsubscription in data

For the new output please refer here


30 March 15

Added

Added associate_ip parameter in create_child_account() function & associate_ip and disassociate_ip parameters in update_child_account() function, to associate/disassociate dedicated IPs with reseller child.


18 March 15

Modified

Modified output of get_user() & display_list_users() functions
Previous output was not having blacklisted_sms in data

For the new output of get_user(), please refer here
For the new output of display_list_users(), please refer here


12 March 15

Modified

Modified output of create_child_account() function
Previous output was not having auth_key in data

For the new output please refer here


9 March 15

Added

Added folder_id parameter in import_users() function, to make newly created list’s desired parent.


26 February 15

Added

Two new possible values replicate & replicate_template in status parameter of function update_campaign_status() to duplicate a classic, trigger, & sms type Campaign and Template, respectively.


17 February 15

Added

Added attachmentUrl and inline_image parameters in create_campaign(), update_campaign(), create_trigger_campaign() and update_trigger_campaign() functions

Added attachmentUrl and attachment parameters in send_transactional_template() function & attach parameter in create_template() and update_template() functions

These parameters are added to feature a campaign with attachments and insert images directly into the email.


30 January 15

Modified

Modified output of get_campaign(s)_v2() function
Previous output was not having entered and modified in data

For the new output please refer here


27 January 15

Added

Added a note in campaign_recipients_export() function, which explains the output of notify_url, when export process is finished.
Previous proc_success parameter returned in the notify_url was having value of campaign id but now its updated with process id.

For the note please refer here


15 January 15

Modified

Modified output of create_update_user() function
Previous output in case of user update was not having id and updated in data

For the new output please refer here


20 November 14

Added

Added is_plat parameter in create_webhook() and get_webhooks() functions


3 November 14

Launched

A new SendinBlue API Version 2.0 is launched. For more details please refer here

Added

New function get_campaigns_v2()
New function get_campaign_v2()
New function share_campaign()
New function get_reseller_child()

Added page & page_limit parameters in get_processes(), get_folders() and get_lists() functions

The above functions are accessible only in API Version 2.0.

Modified

Modified output of get_processes(), get_folders() and get_lists() functions
Previous output was not having page, page_limit and total_records in data

To see the list of functions deprecated in API Version 1.0, please refer here.


31 October 14

Modified

Modified output of get_user() function
Previous output was not having entered in data

For the new output please refer here


23 September 14

Added

New function get_smtp_details()


17 September 14

Added

Added blacklisted_sms parameter in create_update_user() function


28 July 14

Modified

Modified output of get_account() function
Previous output was not having first_name, last_name, email, company, address, city, zip_code and country in data

For the new output please refer here

Modified output of get_user() function
Previous output was not having ip in events like opened & clicks in data

For the new output please refer here


18 July 14

Added

Added status, page and page_limit parameter in get_campaigns() function

Modified

Modified output of get_campaigns() function
For the new output please refer here


15 July 14

Added

New function update_campaign_status()


26 June 14

Added

Added ‘sms_credit’ option in credits parameter of create_child_account() function

Added ‘sms_credit’ option in add_credits and remove_credits parameter of add_remove_child_credits() function


20 June 14

Modified

Modified output of add_users_list() function
Previous output:

For the new output please refer here

Modified response message of send_bat_email() function
Previous response message:

For the new response message please refer here


22 May 14

Added

New function update_child_account()


20 May 14

Added

New function add_remove_child_credits()


19 May 14

Added

New function get_child_account()

Modified

Modified output of get_senders() function
Previous output was not having sign_domain in data

For the new output please refer here


16 May 14

Added

Added type parameter in send_sms() function


15 May 14

Added

New function campaign_share_link()

Modified

Modified output of get_campaign(s) function
Previous output was not having share_link in data

For the new output please refer here


8 May 14

Added

New function delete_child_account()


7 May 14

Added

New function create_child_account()


23 April 14

Added

New function get_senders()
New function create_sender()
New function delete_sender()
New function update_sender()


11 April 14

Added

New function create_update_user()

Discarded

Removed function create_user()
Removed function update_user()


28 March 14

Added

New function create_trigger_campaign()
New function update_trigger_campaign()
New function create_template()
New function update_template()


27 March 14

Added

Added to_field parameter in create/update_campaign() function

Modified

Modified output of get_campaign(s) function
Previous output was not having header, footer, filter, form_name and to_field in data

For the new output please refer here


06 March 14

Added

New function send_bat_email()
New function send_bat_sms()


05 March 14

Added

New function update_sms_campaign()
New function create_sms_campaign()

Modified

Modified output of export CSV file format, added two new columns in the beginning.
Previous CSV file format was not having Campaign ID and Campaign Name.
To check the new columns please use campaign_recipients_export() function


03 March 14

Fix

create_list()/ import_user(): redundant Id


28 February 14

Modified

Modified output of add_users_list() function
Previous output:

For the new output please refer here


27 February 14

Added

Added a feature in function send_email() to send attachments generated on the fly


17 February 14

Added

Added list_parent, entered and camp_stats fields in the get_list(s) functions output


14 February 14

Added

Added a new function display_list_users()


12 February 14

Added

Added type parameter in function get_attribute()


10 February 14

Discarded

Removed function get_user_stats()


31 January 14

Fix

create/update_campaign(): html_url parameter not working


30 January 14

Modified

Modified output of delete_users_list() function
Previous output:

For the new output please refer here

Fix

delete_list(): Null message shown on successful deletion


24 January 14

Added

Added type parameter in function get_campaigns()

Modified

Modified order of parameters in send_sms() function
Previous order of parameters:

For the new order please refer here


23 January 14

Added

Added exclude_list parameter in function create/update_campaign()


16 January 14

Fix

create_campaign(): id not shown


14 January 14

Fix

create/update_campaign(): test mail not sent


13 January 14

Added

Added error message for SMS attribute in output of update_user() function


10 January 14

Fix

delete_users_list(): Unable to delete user from a list


9 January 14

Modified

Modified output of message_sent and events: hard_bounces, soft_bounces, spam, opened and clicks in get_user() function
Previous output:

For the new output please refer here


8 January 14

Fix

update_campaign(): list id lost


7 January 14

Modified

Modified output of get_campaigns() function
Previous output was not having mirror_click, links_message, exclude_list, type and html_content in data

For the new output please refer here


6 January 14

Added

Added headers parameter in send_email() function


13 December 13

Fix

import_users(): zero users imported, while success message shown