SMTP SPECIFICATION

Infobip SMTP API behaves in the same way as any SMTP compliant server (for example your ISP, Gmail, or your corporate email server). This means that you can configure any mail client such as Outlook or Thunderbird to use Infobip SMTP as a relay. There is however a restriction in sender which can be used for relying upon the messages, and of course, you should be authenticated with Infobip supplied credentials.

Following settings should be used to configure the client:

Parameters

Settings Value
Server Name

Required. Provided for each client.

Port 587
User Name / Password

See the "Authentication" section.

Authentication method Normal password
Connection Security STARTTLS

Note: Currently we do not support ports 25 and 465.

Authentication

Supported SMTP authentication mechanisms are PLAIN and LOGIN. Both require username and password.

For basic authentication use Infobip's account username and password.

For authentication with Infobip API key (https://dev.infobip.com/getting-started/security-and-authorization), use username: "App" and then enter the API key as password (same as for authentication over HTTP). ###

Optional headers

Infobip specific information can be included in the email through custom headers.

Currently, supported headers are:

Parameters

Property name Header name Descriptionbul
bulkId X-IB-bulk-id The ID uniquely identifies the sent Email request
trackingUrl X-IB-tracking-url The URL on your callback server on which the open and click notifications will be sent.
intermediateReport X-IB-intermediate-report Set to `true` for receiving the real-time Intermediate delivery report on your callback server.
notifyUrl X-IB-notify-url The URL on your callback server on which the Delivery report will be sent.
notifyContentType X-IB-notify-content-type Preferred Delivery report content type. Can be `application/json` or `application/xml`.
callbackData X-IB-callback-data Additional client's data that will be sent on the `notifyUrl`

 

Supported SMTP commands


Infobip SMTP server supports the following commands:

  • HELP
  • HELO
  • EHLO
  • AUTH
  • MAIL FROM
  • RCPT TO
  • DATA
  • RSET
  • QUIT
  • NOOP
  • STARTTLS

Testing With an email client

To test sending emails over Infobip's SMTP API you can use one of the standard email clients, for example, you can use Thunderbird Mail client.

Steps to configure Thunderbird Mail:

  • After installing Thunderbird on your laptop, configure one of your existing (incoming) email addresses. This step is required because Thunderbird is not willing to send an email without configuring some client email address.
  • Right-click wanted account → Settings → Outgoing Server
  • Click on Add button
  • Set following properties (see also picture below)

Parameters

Settings Value
Server Name smtp-api.infobip.com
Port 587
User Name username
Authentication method Normal Password
Connection Security STARTTLS

Change username with actual account authentication data.

Make sure you set this server as default.

After that, you can start composing the email. Since senders are restricted on Infobip platform, you must use one of your Infobip verified domains (or registered senders) for "from" address. In Thunderbird, this may be achieved by clicking on "Customize From Address" in "From" field.

After this click "send". You may be asked to provide a password on this step.

Note: if your credentials are not correct, or if the sender is not authorized, you will get an appropriate error.