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

FAQ

Where do I sign up to use the API?
You need to first create an account with SendinBlue.com. Once you have signed up, you can access API Console for managing your API Keys.
Where do I get the API keys?
You can access API Console for managing your API Keys. You must use latest version 2.0, access key, for accessing APIs.
How do I migrate from other email platforms?
Currently, you will need to find calls that map into our system on your own. However, going forward we will be providing translated libraries that would let you use our service with very little code change.
How do I migrate from API V1.0 to API V2.0?
With API V2.0, we have made authentication process, easy and simple. You need to download and use latest API 2.0 wrappers (for your choice of language). You also need to use V2.0 API Key from your API Console.

You can learn more on using API V2.0 wrappers here.

See list of functions deprecated in API V1.0 here.

What is the limit on API calls?
The current connection limit is 10 simultaneous connections per user account and we block any connections above that limit. Moreover, we have some rate limit throttling policy and may delay your endpoint calls if we think you are abusive.
Is my programming language supported?
We are a language agnostic platform that support any language as long as it can make HTTP calls. We have a very clean API that you should be able to use pretty easily by following the documentation. We have provided API wrappers in various programming languages e.g. PHP, Node.js, Ruby, C#, Python, Java. You can download the official wrappers from our git hub repository.
Some API calls that I need are missing?
We try our best to cover as much of our platform in our APIs to give as much control to you possible. However, if you feel there are features that you may want please feel free to contact us.
How do I keep up with the changes to the SendinBlue API?
All the changes and updates to API’s are available through release notes.
What output formats are supported by the API?
All SendinBlue API’s provide json response. You can get more details here.
Are there circumstances which would terminate my access to the API?
We do not allow misuse of our systems in any circumstances. Your account will be terminated if the usage does not adhere to our terms of use. You can visit our terms and conditions for more details.
What if I have additional questions?
You can contact our support for any queries related to use SendinBlue API.
Where can I view sample code?
API documentation has detailed examples of each and every API function. You can view the sample code in various languages like PHP, Java, C#, Node.js, Python, Ruby.
What are your plans for the API going forward?
We keep on enhancing and optimizing our API’s. We will be adding more APIs for accessing SendinBlue data over various platforms (mobile, tablets) and through various languages. You can review our release notes for updates.
I want additional features. What do I do?
We would be happy to provide support for all your requirements. You can contact us for any specific requirements.
What if there are errors in the documentation?
We ensure that all the information provided in the documentation is up to date and accurate. Still if you come across any errors, then please contact us. We will get it fixed asap!
Do you have a sandbox environment for testing API?
We do not currently have any sandbox environment for API testing. We will add it in near future for your use.
How to make Curl sample code work on Windows OS?
To make it work, use Curl sample with escape characters.
Example : Curl sample for create_campaign() Api.

Do you support special characters in SMS API?
Our SMS API supports the default GSM characters. You can find out what characters are included in the GSM set here.

You can also paste the text you’re attempting to send on a third-party checker to verify your messages are free of non-GSM characters. Here is an example link that works as of fall 2015.

Please refer below the Special/Unsupported character replacement table.

Special Character Auto-replaced with
ץ C
İ I
ǎ a
Ǎ a
א a
Ǻ a
ǻ a
Ǽ ae
ǽ ae
ב b
צ c
ד d
є e
ע e
Ə e
Є e
ə e
ג g
Ґ g
ґ g
ח h
ה h
ĭ i
ı i
Ĭ i
ǐ i
Ǐ i
י i
Ї i
І i
ї i
і i
ij ij
IJ ij
ĸ k
כ k
ך k
Ŀ l
ŀ l
ל l
מ m
ם m
ן n
ŋ n
נ n
Ŋ n
ʼn n
ŏ o
Ŏ o
ǿ o
ǒ o
Ǿ o
Ǒ o
œ oe
Πoe
פ p
ף p
ק q
ר r
ס s
ט t
ת t
tm
Ǔ u
Ǖ u
ǔ u
Ǜ u
ǚ u
ǜ u
Ǚ u
Ǘ u
ǖ u
ǘ u
ו v
ש w
ז z
ſ z
b
B
d
D
Ð Dh
f
F
Ƒ F
m
M
p
P
s
S
t
T
w
W
w
W
w
W
y
Y
µ u
ъ
Ь
Ъ
ь
Ă A
Ą A
À A
à A
Á A
 A
Þ Th
Ć C
È E
Ę E
Ë E
Ê E
Ğ G
Ï I
Î I
Í I
Ì I
Ł L
Ń N
ɲ nh
Ó O
Ò O
Ô O
Õ O
Ş S
Ś S
Ș S
Š S
Ț T
Ù U
Û U
Ú U
Ý Y
Ź Z
Ž Z
Ż Z
â a
ą a
á a
ă a
ã a
а a
А a
Ā A
ā a
б b
Б b
þ th
ĉ c
Ĉ C
Ċ C
ć c
ç c
ц c
ċ c
Ц c
Č C
č c
Ч ch
ч ch
ď d
Đ D
Ď D
đ d
д d
Д d
ð dh
е e
Е E
ę e
ĕ e
ē e
Ē E
Ė E
ė e
ě e
Ě E
Ĕ E
ê e
ë e
ф f
ƒ f
Ф f
ġ g
Ģ G
Ġ G
Ĝ G
Г g
г g
ĝ g
ğ g
ģ g
ħ h
Х h
Ħ H
Ĥ H
ĥ h
х h
î i
ï i
í i
į i
И i
ĩ i
Ĩ I
и i
Į I
Ī I
ī i
й j
Й j
Ĵ J
ĵ j
я ja
Я ja
Э e
э e
ё e
Ё E
ю ju
Ю ju
Ķ K
К k
к k
ķ k
Л l
ł l
ļ l
ĺ l
Ĺ L
Ļ L
л l
Ľ L
ľ l
М m
м m
н n
Ņ N
Н n
ń n
ņ n
Ň N
ň n
о o
О o
ő o
õ o
ô o
Ő O
Ō O
ō o
ơ o
ó o
Ơ O
п p
П p
ŕ r
ř r
Ř R
ŗ r
Ŗ R
Ŕ R
Р r
р r
ș s
с s
Ŝ S
š s
ś s
ş s
С s
ŝ s
Щ sch
щ sch
ш sh
Ш sh
т t
ŧ t
ť t
ţ t
Ţ T
Т t
ț t
Ŧ T
Ť T
ū u
у u
Ũ U
ũ u
Ư U
ư u
Ū U
ų u
Ų U
ŭ u
Ŭ U
Ů U
ů u
ű u
Ű U
ú u
û u
У u
u
в v
В v
ŵ w
Ŵ W
ы y
ŷ y
ý y
ÿ y
Ÿ Y
Ŷ Y
Ы y
ž z
З z
з z
ź z
ż z
Ж zh
ж zh
oy
What are the possible HTTP status codes returned in API response?
Please refer below the HTTP status code description table.

Code Description
200 Data found – Everything worked as expected
220 No data found – The requested item doesn’t exist
400 Bad Request – Invalid or required parameter missing
401 Unauthorized: No/ Invalid API key provided
423 Request Failed – Parameters were valid but request failed due to expected limitation
500 Server Errors – Something is wrong on SendinBlue’s end
Do you support request timeout in API?
We provide a request timeout, as optional parameter in each library. It’s default value is 30 seconds. Maximum allowed timeout is 60 seconds.