❗️ Important
This article references outdated features - API v2 and the old template language. This information may be used to edit existing templates and API integrations, but should not be used to create new templates or integrations. Instead, refer to this new article to learn how to create and customize your email templates.
The API v2 provides functionality to send templates created in Sendinblue through Sendinblue SMTP (as transactional emails). This API supports only the POST method. The following fields may be sent while making API calls.
| Parameter | Required | Requirement |
Description |
| User | Yes | Username |
Your Sendinblue username can be found in your Sendinblue account on the SMTP & API page on your account |
| Key | Yes | API key |
Your API key(s) can be found in your SendinBlue account on the SMTP & API page on your account |
| Templateid | Yes | Please provide a valid campaign ID whose type is template |
Should be the ID of the campaign whose type is ‘template’ |
| To | Yes | At least one recipient |
Should contain one or more than one (‘|’ separated) recipients. Must be a valid email address |
| Cc | No | Recipient to receive copy |
If provided then must be a valid email address |
| Bcc | No | Recipient to receive copy |
If provided then must be valid email address |
| Attr_1….n | No | Attributes should be provided in JSON format. For example: {"attr1":"value","attr2":"value"} |
In the template, this attribute must be provided inside ‘%%’ in capital letters without spaces (non-accented characters are recommended). If the value of this attribute is provided in the request then in the email it will be replaced with the value in the result. If no such attribute is found then no replacement will be done. Additionally, if in the template, for ex: %PASS% is found and the value of PASS is not provided in the request, then no replacement will be done. You can also have attribute variables in the subject - they will also be replaced while sending the email. |
Examples
Contact attributes can be managed using two different methods:
- Method 1: by using, for example, a fixed value such as surname and first name, which are saved in your Sendinblue contact list database.
- Method 2: by using, for example, a dynamic variable such as an order amount or invoice number, which will be generated during a transaction and sent via the API.
If the attribute has a fixed value, it is in Sendinblue's database, and you want to customize your templates with this type of contact attribute, then the attribute name needs to be placed in curly brackets {}.
Example: Hello {FIRSTNAME}
On the other hand, if the attribute has a dynamic value and is sent by the API, the attribute name needs to be placed between %%.
Example: Order amount: %ORDER_AMOUNT%
You can use both types of attributes in the same template to personalize your email like this:
If the template contains Hello %LNAME% %FNAME%, this is the email sent through Sendinblue SMTP as a test. Regards,, then the real content that will appear in your mailbox (youremail@email.com) will look like this: Hello John Smith, this is the email sent through Sendinblue SMTP as a test. Regards,.