How do I setup a Custom Email Domain for my forms?

Please note that this feature is exclusively available with specific pricing plans.

Required account permissions

Custom email domain requests must be initiated by users with owner or admin permissions on select plans. If you are a sub-user and your account type is user or viewer, you must ask someone with the appropriate permissions to process this request on your behalf.

Custom email domain setup

Custom email domains require some setup for your account and also on each form that should use the domain.

For your account, you will need to

  1. Create an account with an email provider that supports sending via SMTP. Follow your providers setup instructions to ensure your emails are deliverable.
  2. Navigate to your Account Settings page, and select "Custom Email Domains" from the sidebar.
  3. Click the "Add New Domain" button and complete the form to configure your custom email domain.
  4. Once your domain is configured you can use the test button in the context menu to send a test email from your domain to your Paperform account email.
  5. Your domain is now ready to use on your forms.

To send submission emails from your form with your custom email domain set the "From address" in your custom email configuration to an email address that matches your custom email domain e.g. "me@example.com" would match the custom email domain "example.com".

Custom email domain sending behaviour

When you configure you custom email domain you can choose between two options: "Always send with default from address" and "Send with any address ending in your domain". Depending on which option you have selected your the sending behaviour varies slightly.

When "Always send with default from address" is selected we:

  • Check if any of your custom email domains match the domain on your emails "From address".
  • If one matches we will send your email from the default from address for that domain.
  • Otherwise we will send from our default from address "no-reply@paperform.co" and use your configured from address as the reply to address.

When "Send with any address ending in your domain" is selected we:

  • Check if any of your custom email domains match the domain on your emails "From address".
  • If one matches we will send your email from the from address configured for that email.
  • Otherwise we will send from our default from address "no-reply@paperform.co" and use your configured from address as the reply to address.

Gotchas

Delivery issues

When using a custom email domain you are responsible for ensuring the correct configuration of your domain and handling any outages or services issues that arise with your email provider.

You will need to ensure your email provider is correctly configured for your custom email domain otherwise your emails may bounce or be spam filtered.

SMTP credentials using multi-factor authentication (MFA or 2FA)

We don't support the use of SMTP credentials that require the use of MFA/ 2FA or a one-time passcode, as Paperform doesn't have access to your secondary device to generate a new passcode.

Instead, we recommend producing an inbox or new set of credentials that don't require this additional step for use on Paperform.

When attempting to add credentials that require MFA, you will see the message "Server Error".