Custom domain and email server

LIMITED ACCESS

This feature is a limited access release. Limited access features are those that have passed the development phase and are now ready for customer use. Our goal is to gather your input to ensure their reliable release in upcoming enhancements.

During the limited access release, Workato may update its functionality or change its availability to customers without prior notice.

The custom domain and email server features work together to provide a personalized and branded experience for Workflow app users. This ensures a seamless experience between your application and Workflow apps.

CNAME AND SPF RECORD SETUP

Configuring a custom domain and email server involves adding a CNAME and an SPF record to your DNS settings. A CNAME aliases one domain to another and is required for a custom domain setup, while an SPF record specifies authorized mail servers. Although both can be used in the same registered domain, they can't coexist on the same domain or subdomain. For example, you can use a CNAME for a subdomain like www.example.com and an SPF record for the root domain, example.com.

Custom domain

A custom domain enables you to use your own domain name instead of the default Workato domain ({customer_subdomain}.workato.app) for your Workflow apps. This means that you can set up your DNS (Domain Name System) domain to access the Apps portal, pages, tasks, links, and email communications using a custom domain.

Custom domains follow the {custom_subdomain}.{customer_domain}/portal format. For example:

https://apps.idea-lifestyle.net/portal

Set up a custom domain

PREREQUISITES

To set up a custom domain for your Workflow apps, you must have the following:

• A domain to which you have permissions to manage DNS records. You can prepare a registered domain name or use an existing domain for this purpose. For more information on domain names, see the ICANN documentation (opens new window).

Complete the following steps to set up a custom domain:

1

In Workato, use the sidebar navigation to go to Platform > Workflow apps portal > Settings > Custom domain and email server and click Add domain.

Add a domain

2

Enter your full domain name, including the subdomain, and click Add domain. For example, apps.idea-lifestyle.net.

Register a domain

3

Verify your domain by configuring the CNAME record in your DNS settings

1

In your DNS manager, go to Websites and select your domain. This example uses Cloudflare (opens new window).

2

Open DNS > Records and click + Add record.

3

Select CNAME as the Type and supply your subdomain name in the Name field. For example, apps.

4

Provide the Target. Copy and paste the Value from Workato. For example:

apps-custom.workato.app

The Value/Target varies based on the data center that serves your Workato workspace. Use the URL that matches your data center:

• US Data Center: apps-custom.workato.app
• EU Data Center: apps-custom.eu.workato.app
• SG Data Center: apps-custom.sg.workato.app
• JP Data Center: apps-custom.jp.workato.app
• AU Data Center: apps-custom.au.workato.app

5

Set the Proxy status to DNS only.

6

Click Save.

Add a CNAME record to your DNS settings

4

Depending on your domain host, it can take up to 24 hours for the new CNAME record to propagate through the global domain name system. After verifying your custom domain's DNS, Workato generates an SSL certificate. It can take up to an hour for the certificate to be issued and ready for use. Refresh the Custom domain and email server page to check on the status.

Domain verification pending

Domain verified

Custom email server

Workato allows you to send emails from your Workflow apps using SMTP (Simple Mail Transfer Protocol). This feature enables you to send emails from addresses like {username}@{customerdomain}.com instead of the default [email protected]. By using your organization's email server, such as Exchange Online or Gmail, you can maintain consistency in your communications.

Set up a custom email server in Workato

Complete the following steps to set up your custom email server in Workato. This process involves obtaining values from your SMTP email server.

1

In Workato, use the sidebar navigation to go to Platform > Workflow apps portal > Settings > Custom domain and email server and click Add email server.

Add email server

2

Configure your email server

1

In the Server field, add your SMTP email server value. For example, smtp.gmail.com.

2

In the From email address field, provide an email address from which you plan to send Workflow apps communications. Users will see this email address in all correspondence. For example, [email protected].

3

In the User name field, add your SMTP email server username.

4

5

In the Password field, enter your SMTP email server password.

6

Supply a Port number. Workato recommends using 587, which is used for secure transfer of emails and is supplied by default.

7

Click Next.

Email server setup

3

In the Send to email address field, provide your email address and click Send test email. Workato sends a test email to this address to verify the email server is working.

4

Check your inbox and spam folder to confirm the email was sent successfully.

Email verification sent

5

Click Add email server.