Get started

Here you’ll find the complete process for getting started with Infobip Email. This section describes the steps to register your domain with Infobip, and how to insert records to the DNS and register the sender.

This section also includes our recommended best practices to optimize delivery.

By using Infobip Email as a communications channel, our goal is to deliver all emails that you send to your targeted inboxes. For the best chance of the successful delivery of your emails, follow this guide to ensure the best results.

Managing senders

To use email in Infobip, you need to register your company's domain. There are two choices when onboarding your domain:

Go straight to onboarding your official company domain (see Register a New Domain)
Test your Infobip email service without the need to make DNS changes (see Test a Single Sender)

Deciding which option to choose depends on whether you are ready to go straight to production with your domain, or if you wish to conduct tests before moving to production.

Test a single sender

Setting up a new domain requires various DNS changes and may impact the email service. Before registering a new domain, you may test the email service by testing a single sender domain.

Infobip lets you verify a single sender domain with up to a maximum of 100 emails before you decide to continue to use this as the official company domain.

The single sender can be a publicly registered mailbox (for example, outlook.com).

Note

This mailbox should be used for testing traffic ONLY.

You cannot use Yahoo or Gmail addresses for testing a single sender.

To set up the single sender:

In the web interface, select Channels and Numbers > Email and then click on Marketing & Transactional.

You see the Senders page listing the currently registered senders that can send email on Infobip.
Click Add New, and then select Single Sender from the drop-down list.
On the Single Sender Registration form, enter the personal and company details:
- From email
- Sender name
- Reply-to-email
- Company address
- Optional City and Country
Click Create. A new sender is created but in the status it is unverified. An email is sent to the sender email, which contains a link. Click the link and the status changes to sender_verified.
The single sender is available as a option in From field when sending messages with Broadcast and API.

For example, verify an email name [email protected] as a single sender. All single sender email traffic is sent via internal domains and the From field in the recipient inbox displays [email protected] via ss-messaging-1.com (opens in a new tab) or ss-messaging-2.com (opens in a new tab).

Register a new domain

To use fully-featured email in Infobip, you need to register your company's domain. This step is necessary to confirm ownership of the user accounts and so enable you to send emails from any email address within that domain.

To verify your domain, you need the Domain Name System (DNS) records to apply to your hosting provider. It is possible to obtain your DNS records by requesting them from your dedicated Account Manager, however, the recommended way is to produce them in Channels and numbers in the web interface.

To set up your sender domain:

In the web interface, select Channels and Numbers > Channels > Email and then click on Marketing & Transactional.
You see the list of domains that you have set up, along with information about whether they are verified or unverified. If you wish to set up email domains for using email with Conversations, go to the Conversations tab.
Click Add New, and then select Domain from the drop-down list to add a new sender domain and set up the configuration. You then see the Authenticate your domain form.
On the Authenticate your domain form, enter the domain name and the authentication settings:
1. Enter a Domain name. You do not need to add a prefix, for example, https:// or www (opens in a new tab).
2. Enter your Targeted Daily Traffic to be used for Automatic warmup. The limit that you set applies until your domain reaches the set targeted daily traffic. Note that automated warmup is enabled only for web interface users. For more information, see IP/Domain warmup.
3. Select the DKIM key length. The Domain Keys Identified Mail (DKIM) is a protocol used so the receiver can verify the provider and requires you to specify the character length. You can select either the 1024-bit or 2048-bit character length. Higher numbers provide better security making it more difficult for hackers to break. The DKIM key length is a one-time selection and you cannot change the value later.
4. Enter an optional mailbox address for a Custom Return Path Address. A default return path is included in the message header and is set to an address with the same domain as the sender. The custom return path allows you to define a different, customized return path for every message sent from this domain. The address must include numbers and letters only.
5. Choose an option that describes the purpose of the domain:
  - Marketing - for commercial emails that are promotional
  - Transactional - for non-commercial emails for a commercial transaction or a website action
  - Not defined - for emails that have no specific purpose when you set up the domain, and which can be changed later (see Manage domain settings)
Click Set Up Domain to finish your domain configuration. You see the records for your sender domain to be verified.

Verify your sender domain

To verify your sender domain, you add the DNS records to your hosting provider and wait for the propagation of records within the DNS. Note that propagation can take up to 48 hours. Once the records are propagated, your sender domain is seen as verified and ready for use.

See the tutorials for some of the most common web providers and how to add DNS records to their websites.

Domain verification status is visible in the domain list above domain name. Verified domains are in green and unverified in red.

Manage domain settings

To see a list of the currently registered senders, in the Infobip web interface, select Channels and Numbers > Channels > Email and then click on Marketing & Transactional.

On the right-side of the domain, select the three-dot menu, and click Manage.

You see the Domain Settings page where you can manage the options that you set when you created the domain.

The following sections describes the tabs on the Domain Settings page.

DNS records

Lists the mandatory and optional DNS records for email delivery.

TXT records are applied automatically to your domain.

RECORD TYPE	RECORD VALUE	RECORD PURPOSE
TXT	v=spf1 include:email-messaging.com ~all	SPF - Specifies the domain to be recognized as approved to send emails from it.
TXT	Find the value of this record in Domain details under Expected Value column	DKIM - Preventing scammers, specifically phishers, from spoofing your organization and can lead to potential improvements to your overall deliverability
CNAME	emailtracking.email-messaging.com	It enables the links within your emails to contain the domain you use for sending and not Infobip default tracking domain.
CNAME	Find the value of this record in Domain details under the Expected Value column. The DMARC record starts with `_dmarc`.	DMARC authenticates the domain in your `from-address`, which makes your emails even more trustworthy, and returns reports that can help to spot configuration or spoofing issues.

Three records are also applied to your domain setup that ensure better deliverability.

RECORD TYPE	RECORD VALUE	RECORD PURPOSE
A	Find the value of this record in Domain details under Expected Value column	Maps a domain name to the IP address. If your domain already has an A record, the same value should be set automatically. It is also possible that in some scenarios, this record is not created. For example, for the subdomain registration.
MX	mx.email-messaging.com	Specifies the mail server responsible for accepting email messages on behalf of a domain name and increases deliverability. The priority of the record should be 10.

Once mandatory TXT records have been propagated, you are ready to send and test emails.

Before that, there are a few steps that you are advised to follow to establish optimal delivery. See Next Steps for more information.

Domain purpose

You set the domain purpose when creating a domain. Use the domain purpose tab to change the main purpose for the domain usage.

Choose the purpose of the domain from the following options:

Marketing - for commercial emails that are promotional
Transactional - for non-commercial emails for a commercial transaction or a website action
Not defined - for emails that have no specific purpose.

Tracking

Tracking let you choose how to track the domain by selecting options with the on/off toggle switches. The following tracking options are available:

Open Tracking - lets you know when any email you sent has been opened or clicked
Unsubscribe tracking - collects and manages all unsubscribes with a do not contact list
Click tracking - lets you know how many times subscribers interact with links in the emails you dispatch

For more information, see Tracking.

Custom return path

The custom return path is an optional mailbox address that you set when creating a domain. Use the Custom f you wish to change the mailbox address that you wish to be used for the return path for email messages from this domain, enter a new mailbox in the Custom Return Path Address field.

The address must include numbers and letters only.

Inbound parsing

Inbound parsing is used to parse the contents of incoming emails and direct them to a external server.

When emails are received by the reply-to address from outbound email traffic, you can set up an HTTP Push action that directs the email data to your chosen destination, which is set up using a webhook.

Infobip then automatically parses those emails and then pushes the parsed data to your chosen destination.

Prepare for inbound parsing

Before you can start using inbound parsing on emails, ensure that you have set up the following:

Inbound Parsing must be enabled for the account. If you cannot see Inbound on the Domain settings it means it has not been enabled for your account. Contact Support (opens in a new tab) for more information about enabling Inbound Parsing.
Register a sender domain using the steps in Register a new domain.
Ensure that the registered domain has a valid MX record using the steps in Email DNS records.

Manage inbound parsing

Once you have registered an enabled domain and set a valid MX record, use the following steps to set up inbound parsing:

Go to Channels and Numbers > Channels > Email.
Choose the registered domain that you have prepared for inbound parsing.
Click the three dots next to the domain you want to set up inbound parsing and select Manage.
Select the Inbound tab.
Select the inbound parsing Action as HTTP Push.
Enter the Webhook destination as your chosen external server. For example, https://mywebhook.receiver.net
Click Save.

Receiving parsed inbound traffic

If you have configured the reply-to address for the email you sent to use a domain enabled for inbound parsing, when replies are sent to the reply-to address, the payload is parsed and passed on to the webhook destination you chose.

An example of the pushed payload is available on Receive parsed emails (opens in a new tab) in the API documentation.

Set up email domain for Conversations

Set up an email domain for the Infobip Conversations solution to allow your call center agents to reply to customer emails from within the Conversations agent panel.

See the section on Email setup in Conversations for more information.

Manage suppressions

Suppression list manager allows the owner of a sender domain to manage suppressions generated by that sender domain, and to share view or edit rights with others who use that same sender domain.

The suppression list gives you control over suppression without the need for intervention from Infobip Support. Time is critical when you want to send transactional or service update emails, and so this feature lets you remove addresses from suppression lists immediately and without delay.

There are three suppression categories that are important when managing your suppression list:

Bounces: addresses that have been hard bounced, meaning that they are inactive or invalid
Complaints: valid email addresses that issue a spam complaint
Overquota Bounces: valid email addresses that have run out of storage space (and therefore temporarily can't accept additional emails)

To use the Suppression list, you need an Infobip account with both the required user permissions and at least one dedicated IP to perform all possible operations (view, add and remove):

User Rights: The account that is the owner of a sender domain automatically has full user permissions to manage suppressions (with one exception, see next section). Accounts that are not the owner but are a user of the same sender domain can be given the required user permissions by the owner account.
Dedicated IPs: To remove any bounces or complaints, just having the required user rights is not enough. It is also required that the sender domain in question uses at least one dedicated IP. Accounts are prevented from removing addresses for any domains that only use shared IP addresses, irrespective of user permissions. If a domain has a dedicated IP, address removal is allowed, but without a dedicated IP, removal is not possible. For instance, if you are an owner with a dedicated IP, the delete permission will be enabled (true). However, if you are an owner without a dedicated IP, the delete permission will be disabled (false).

	Bounce	Complaint	Overquota
View	Domain owner: automatically has view rights Domain user: requires user permissions	Domain owner: automatically has view rights Domain user: requires user permissions	Domain owner: automatically has view rights Domain user: requires user permissions
Add	Domain owner: automatically has add rights Domain user: requires user permissions	Domain owner: automatically has add rights Domain user: requires user permissions	Domain owner: adding not possible Domain user: adding not possible
Delete	Domain owner: automatically has delete rights and domain to use at least one dedicated IP Domain user: requires user permissions and domain to use at least one dedicated IP	Domain owner: automatically has delete rights and domain to use at least one dedicated IP Domain user: requires user permissions and domain to use at least one dedicated IP	Domain owner: automatically has delete rights and domain to use at least one dedicated IP Domain user: requires user permissions and domain to use at least one dedicated IP

Manage suppression over web interface

You can use the Suppression list feature in the Email channel in the web interface. The Suppression list provides a visual display of all the recipients associated with the sender domains, offering selected filtering and search to assist you in finding recipient addresses. You can also add recipients and manage their permissions.

To manage suppressions, you initially need to select the sender domain:

On the web interface, go to Channels and Numbers > Channels > Email. Select the Suppression List tab.
Select the sender domain from the Sender Domain drop-down list. At Infobip, suppressions are stored against sender domains, which means that each sender domain has its own suppression list. When you have selected the sender domain, you see the list of recipient addresses that have been added to this sender domain and three tabs that represent the suppression categories: Bounces, Spam Complaints, and Overquota Bounces.

If you know the address, click the search icon and you can find it in the list by typing it in the search box.

For each of the categories, there are two filters. Use the filter icon to toggle these options. You have the choice to filter on the following:
- Recipient Domain: select one recipient domain to filter on the recipient domain.
- Period: select a duration to filter the suppressions based on a period of time, or choose a custom period start and end

Add recipients to suppression list

From the Suppression list, you can add recipients to the selected sender domain.

Click Add Recipients. You see a drop-down list where you can choose either:
- Bounces
- Spam complaints
Overquota bounces are not in this list because they can only be viewed and not added.

You'll then see a window where you can upload any bounces or spam complaints.
Select the Sender domain. Suppressions are stored against sender domains, so this will add the recipient addresses that bounced/complained to the selected sender domain.
Choose either to manually add the recipients one by one or by uploading a CSV / Excel file containing a list of recipient addresses.
- Upload from file: drag and drop a file onto the Upload from file window or click Browse to find the file in your file manager. The file must consist of email values separated by commas (CSV) or a single column with ones (XLS, XLSX). Make sure that the file does not contain records with syntax errors and empty records otherwise it will not be imported.
- Add one by one: enter the email addresses for in the text box. Add the email addresses one by one, or paste them and separate them using the Enter key. You can add up to 100 email addresses. Then click Add Records.

Manage access permissions

From the Suppression list, you can manage the permissions for other accounts who use the same sender domains. It is only possible to manage the permissions if the account the user is logged into is the owner of that sender domain.

You can assign view, edit, and delete rights for each owned sender domain and to each of the account's subaccounts.

To manage permissions, click the three vertical dots next to the Add Recipients button. You see the Manage access permissions panel. The panel contains two tabs:

Give permissions
Received permissions

Give permissions

To add a new permission, click Add Permission. You should provide the following information:

The subaccount to whom you want to give permissions
The sender domain for which you want to give permissions to that subaccount (note that Infobip stores suppressions against the sender domain)
Whether the subaccount can view or add bounces and spam complaints, and whether it can view overquota bounces

Once you've completed this form, click Save and the permissions will be applied to the subaccount you chose.

Received permissions

When you receive permissions, you'll be able to see them in the Received Permissions tab. The permissions you receive are grouped by the sender domain to which they apply. Click on the sender domain to see more details on which permissions exactly you received for that domain.

Manage suppression over API

The Email API offers four endpoints for Email suppression:

Get suppressions (opens in a new tab): This method retrieves the suppressions for domains that are owned or have permissions granted. Per request the user can retrieve up to 1000 suppressions for up to 1 sender domain.
Add suppressions (opens in a new tab): This method allows you to add email addresses to the suppression list. It accepts suppression requests, saves them asynchronously, and automatically ignores any duplicate entries. Per request the user can add 1000 suppressions for each sender domain provided (maximum 10 sender domains per request).
Delete suppressions (opens in a new tab): This method allows you to delete email addresses from the suppression list. It accepts delete suppression requests and asynchronously deletes them. Per request the user provide up to 10 sender domains, and provide for each sender domain up to 1000 suppressions for removal.
Get suppression domains (opens in a new tab): This method allows you to get domains that can be managed for suppressions and are either owned or have granted permissions.

Common providers on editing TXT records

Here is a list of some of the most common domain/hosting providers on how to edit TXT records:

Infobip notifies you by email once DNS records are changed and once your domain is verified and ready to use. You’ll also see the verified label next to the domain. Note however, domain verification can take up to 48 hours due to the propagation delay between Infobip and your service provider.

You can then set up tracking for each domain. By default, tracking is enabled, but you can remove this as required.

Next steps

Now that you have set up your sender domain(s) and/or subdomain(s), it's time to move on to the Deliverability Recommendations to ensure you are up to scratch with the best practices when using Email as your communication channel.

This protects you from spam detectors and builds up your reputation to be a trusted email sender.

Overview Deliverability recommendations