Email: Send a Form

Use this action to send a web-form via email to someone not part of your Catalytic team. The form can be used to collect information from the people that it is sent to.

Only 1 person can complete each emailed form. Any additional people who open the same form from the email link will receive a form completed page.

Use Case

This action can be like a survey or for general data collection, particularly from non-team members. This task is helpful to use when you need to obtain a variety of information. For example,

  • Requesting information from a new hire in an onboarding process
  • Post-meeting surveys
  • Vendor request, placing an order, or returning an item within procurement

How to configure this action

Fields for this action

  • To address

    • A specific email address or a reference field from a prior task or instance. The to address is required.
  • CC

    • Add any email addresses in a comma separated list to include in the CC. This is useful for notifying someone of the task, like for compliance or mailing lists.
  • BCC

    • Add any email addresses in a comma separated list to include in the BCC. This is useful for sending emails to large mailing lists where the list should remain private.
  • Sender name

    • The name of the company or person this email is coming from. The sender name is not required.
  • Email subject

    • The email reference line. The email subject is required.
  • Email body

    • The message in the email describing what the form is for. This is different than the form instructions. The email body is not required.
    • Set a custom footer for an email, such as including an unsubscribe link. This field supports markdown.
  • Attachments

    • Any documents for the recipient. This may include guidelines, necessary data, or templates to complete. Attachments are not required
  • Custom Reply-To Email Address

    • By default, replies to the email sent by this action are added as comments on the run.
    • Enter an email address to instead have replies sent to a custom reply-to address. If a custom reply-to email address is used, replies are not added as a comment on the run.
  • Form title

    • The title will be at the top of the form once “Get Started” is selected from the email. The form title is not required.
  • Form instructions

    • This will appear at the top of the form, underneath the title and above the first field.
  • Mark complete on bounce

    • Select True or False from the drop down to choose how the task is handled if an email cannot be delivered.
      • Select True to mark this task complete when the email cannot be delivered.
      • Select False or leave blank to leave the task open so that the web form can be completed manually or the instance canceled.

    💡Tip: Bounce output fields are added to the task when an email bounces. Automated bounce handling can be configured by using the bounce output fields in task conditions.

  • Output Field Prefix

    • To help keep output fields organized, choose a prefix that will be added to the beginning of each output field name as this action may output more than one field.

What will this output?

Bounce output fields are added to the task when an email bounces. Automated bounce handling can be configured by using the bounce output fields in task conditions.

This action may generate multiple fields. To help keep output fields organized, the prefix above will be added to the beginning of each of the output field names, separated by two dashes. Each field will result as:{{output-field-prefix--output-field}}.

Output fields for this action

  • To

    • A list of all recipients of the email a form task.

Additional Output fields if an email bounces

  • Email bounced

    • A TRUE or FALSE response for whether or not an email bounced.
  • Bounced email address

    • A list of all the email addresses where the email bounced.
  • Bounce message

    • This will capture the message returned by the addresses where the email bounced.
  • Bounce type

    • The bounce type for the bounced email.

Get help with a problem or question

If something’s not working as expected, or you’re looking for suggestions, check through the options below.

Why are the bounce fields always empty?

After an email is sent, if it bounces this action normally returns extra output fields like: Email bounced, Bounced email address and Bounce message.

A common reason why these fields may not appear or appear blank is if the process ends before the email bounces. If an email is opened or bounces after the process ends, the fields cannot be updated.

To avoid this, add a task with a delay after the email task, or set up the Workflow so this task is not the last task in a process.

Why are my emails not sending?

If you get the bounce message “Catalytic has sent too many emails to this address recently. Please try again later”:

  • Catalytic limits the number of emails you can send to a single email address to 100 emails per hour. Exceeding that amount, under all circumstances, will trigger this message.

  • If you have a business case that requires you to send over 100 emails an hour to a single recipient, please contact support at help@catalytic.com.

If you have the comment on the instance, “Catalytic did not send your email … because an email with the exact same subject and body was sent to this address within the last hour.”:

  • Catalytic has an built-in spam prevention system to limit unintentional duplicate emails—this is intended to help avoid accidental spam, or embarrassing duplicates.

  • This error occurs if an email with an identical body and subject line has been sent to the same email address within the last hour. To send the exact same email, wait an hour.

  • To bypass the spam protection, see How do I bypass the spam protection altogether?.

How do I bypass the spam protection altogether?

To bypass the spam prevention, make each email unique. For example, add the Run Start Date to each email—this globally available field includes the start date in 2020-01-22T16:35:55.342Z format. This will ensure all emails are sent, even if all other content is the same.

💡Tip: To make the date format more readable, use the Dates: Format a date time action with a format like D/M/Y HH:mm:ss.