All URIs are relative to https://api.sendinblue.com/v3
Method | HTTP request | Description |
---|---|---|
BlockNewDomain | Post /smtp/blockedDomains | Add a new domain to the list of blocked domains |
CreateSmtpTemplate | Post /smtp/templates | Create an email template |
DeleteBlockedDomain | Delete /smtp/blockedDomains/{domain} | Unblock an existing domain from the list of blocked domains |
DeleteHardbounces | Post /smtp/deleteHardbounces | Delete hardbounces |
DeleteSmtpTemplate | Delete /smtp/templates/{templateId} | Delete an inactive email template |
GetAggregatedSmtpReport | Get /smtp/statistics/aggregatedReport | Get your transactional email activity aggregated over a period of time |
GetBlockedDomains | Get /smtp/blockedDomains | Get the list of blocked domains |
GetEmailEventReport | Get /smtp/statistics/events | Get all your transactional email activity (unaggregated events) |
GetSmtpReport | Get /smtp/statistics/reports | Get your transactional email activity aggregated per day |
GetSmtpTemplate | Get /smtp/templates/{templateId} | Returns the template information |
GetSmtpTemplates | Get /smtp/templates | Get the list of email templates |
GetTransacBlockedContacts | Get /smtp/blockedContacts | Get the list of blocked or unsubscribed transactional contacts |
GetTransacEmailContent | Get /smtp/emails/{uuid} | Get the personalized content of a sent transactional email |
GetTransacEmailsList | Get /smtp/emails | Get the list of transactional emails on the basis of allowed filters |
SendTemplate | Post /smtp/templates/{templateId}/send | Send a template |
SendTestTemplate | Post /smtp/templates/{templateId}/sendTest | Send a template to your test list |
SendTransacEmail | Post /smtp/email | Send a transactional email |
SmtpBlockedContactsEmailDelete | Delete /smtp/blockedContacts/{email} | Unblock or resubscribe a transactional contact |
SmtpLogMessageIdDelete | Delete /smtp/log/{messageId} | Delete an SMTP transactional log |
UpdateSmtpTemplate | Put /smtp/templates/{templateId} | Update an email template |
BlockNewDomain(ctx, body) Add a new domain to the list of blocked domains
Blocks a new domain in order to avoid messages being sent to the same
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | BlockDomain |
(empty response body)
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
CreateModel CreateSmtpTemplate(ctx, body) Create an email template
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | CreateSmtpTemplate | values to update in transactional email template |
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DeleteBlockedDomain(ctx, domain) Unblock an existing domain from the list of blocked domains
Unblocks an existing domain from the list of blocked domains
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
domain | string | The name of the domain to be deleted |
(empty response body)
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DeleteHardbounces(ctx, optional) Delete hardbounces
Delete hardbounces. To use carefully (e.g. in case of temporary ISP failures)
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiDeleteHardbouncesOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiDeleteHardbouncesOpts struct
Name | Type | Description | Notes |
---|---|---|---|
body | optional.Interface of DeleteHardbounces | values to delete hardbounces |
(empty response body)
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
DeleteSmtpTemplate(ctx, templateId) Delete an inactive email template
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
templateId | int64 | id of the template |
(empty response body)
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetAggregatedReport GetAggregatedSmtpReport(ctx, optional) Get your transactional email activity aggregated over a period of time
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetAggregatedSmtpReportOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetAggregatedSmtpReportOpts struct
Name | Type | Description | Notes |
---|---|---|---|
startDate | optional.String | Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate | |
endDate | optional.String | Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate | |
days | optional.Int64 | Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate' | |
tag | optional.String | Tag of the emails |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetBlockedDomains GetBlockedDomains(ctx, ) Get the list of blocked domains
Get the list of blocked domains
This endpoint does not need any parameter.
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetEmailEventReport GetEmailEventReport(ctx, optional) Get all your transactional email activity (unaggregated events)
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetEmailEventReportOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetEmailEventReportOpts struct
Name | Type | Description | Notes |
---|---|---|---|
limit | optional.Int64 | Number limitation for the result returned | [default to 50] |
offset | optional.Int64 | Beginning point in the list to retrieve from. | [default to 0] |
startDate | optional.String | Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate | |
endDate | optional.String | Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate | |
days | optional.Int64 | Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate' | |
optional.String | Filter the report for a specific email addresses | ||
event | optional.String | Filter the report for a specific event type | |
tags | optional.String | Filter the report for tags (serialized and urlencoded array) | |
messageId | optional.String | Filter on a specific message id | |
templateId | optional.Int64 | Filter on a specific template id | |
sort | optional.String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [default to desc] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetReports GetSmtpReport(ctx, optional) Get your transactional email activity aggregated per day
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetSmtpReportOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetSmtpReportOpts struct
Name | Type | Description | Notes |
---|---|---|---|
limit | optional.Int64 | Number of documents returned per page | [default to 10] |
offset | optional.Int64 | Index of the first document on the page | [default to 0] |
startDate | optional.String | Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD) | |
endDate | optional.String | Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD) | |
days | optional.Int64 | Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate' | |
tag | optional.String | Tag of the emails | |
sort | optional.String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [default to desc] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetSmtpTemplateOverview GetSmtpTemplate(ctx, templateId) Returns the template information
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
templateId | int64 | id of the template |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetSmtpTemplates GetSmtpTemplates(ctx, optional) Get the list of email templates
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetSmtpTemplatesOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetSmtpTemplatesOpts struct
Name | Type | Description | Notes |
---|---|---|---|
templateStatus | optional.Bool | Filter on the status of the template. Active = true, inactive = false | |
limit | optional.Int64 | Number of documents returned per page | [default to 50] |
offset | optional.Int64 | Index of the first document in the page | [default to 0] |
sort | optional.String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [default to desc] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTransacBlockedContacts GetTransacBlockedContacts(ctx, optional) Get the list of blocked or unsubscribed transactional contacts
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetTransacBlockedContactsOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetTransacBlockedContactsOpts struct
Name | Type | Description | Notes |
---|---|---|---|
startDate | optional.String | Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the blocked or unsubscribed contacts | |
endDate | optional.String | Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the blocked or unsubscribed contacts | |
limit | optional.Int64 | Number of documents returned per page | [default to 50] |
offset | optional.Int64 | Index of the first document on the page | [default to 0] |
senders | optional.Interface of []string | Comma separated list of emails of the senders from which contacts are blocked or unsubscribed | |
sort | optional.String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [default to desc] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTransacEmailContent GetTransacEmailContent(ctx, uuid) Get the personalized content of a sent transactional email
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
uuid | string | Unique id of the transactional email that has been sent to a particular contact |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
GetTransacEmailsList GetTransacEmailsList(ctx, optional) Get the list of transactional emails on the basis of allowed filters
This endpoint will show the list of emails for past 30 days by default. To retrieve emails before that time, please pass startDate and endDate in query filters.
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
optional | *TransactionalEmailsApiGetTransacEmailsListOpts | optional parameters | nil if no parameters |
Optional parameters are passed through a pointer to a TransactionalEmailsApiGetTransacEmailsListOpts struct
Name | Type | Description | Notes |
---|---|---|---|
optional.String | Mandatory if templateId and messageId are not passed in query filters. Email address to which transactional email has been sent. | ||
templateId | optional.Int64 | Mandatory if email and messageId are not passed in query filters. Id of the template that was used to compose transactional email. | |
messageId | optional.String | Mandatory if templateId and email are not passed in query filters. Message ID of the transactional email sent. | |
startDate | optional.String | Mandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Maximum time period that can be selected is one month. | |
endDate | optional.String | Mandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month. | |
sort | optional.String | Sort the results in the ascending/descending order of record creation. Default order is descending if `sort` is not passed | [default to desc] |
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SendTemplateEmail SendTemplate(ctx, body, templateId) Send a template
This endpoint is deprecated. Prefer v3/smtp/email instead.
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | SendEmail | ||
templateId | int64 | Id of the template |
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SendTestTemplate(ctx, body, templateId) Send a template to your test list
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | SendTestEmail | ||
templateId | int64 | Id of the template |
(empty response body)
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
CreateSmtpEmail SendTransacEmail(ctx, body) Send a transactional email
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | SendSmtpEmail | Values to send a transactional email |
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SmtpBlockedContactsEmailDelete(ctx, email) Unblock or resubscribe a transactional contact
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
string | contact email (urlencoded) to unblock. |
(empty response body)
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
SmtpLogMessageIdDelete(ctx, messageId) Delete an SMTP transactional log
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
messageId | string | MessageId of the transactional log to delete |
(empty response body)
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
UpdateSmtpTemplate(ctx, body, templateId) Update an email template
Name | Type | Description | Notes |
---|---|---|---|
ctx | context.Context | context for authentication, logging, cancellation, deadlines, tracing, etc. | |
body | UpdateSmtpTemplate | values to update in transactional email template | |
templateId | int64 | id of the template |
(empty response body)
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]