Skip to main content
Version: 10 - TBD

Email Integration

Cloudomation Engine can send and receive emails.

Use Cases

With the email integration you can:

  • Send notifications about the status of an automated process.
  • Start an execution for each incoming email.
  • Add email approval steps to your automation processes.

Concept

Receiving Emails

Engine can receive emails from any IMAP server using the IMAP connector. See also the Connector Type IMAP documentation.

note

Engine currently only supports polling the IMAP server for messages. Push notifications are not currently implemented.

Sending Emails

There are two ways to send emails:

  • Through any SMTP server using the SMTP connector. This method allows to send to any email address. See Connector Type IMAP.

  • Through the SMTP integration. Using this method is simpler, but emails can only be sent to the email addresses of existing Engine user accounts in your workspace. See send_mail().

    :::tip example To send an email to yourself:

    import flow_api
    def handler(system: flow_api.System, this: flow_api.Execution, inputs: dict):
    system.get_own_user().send_mail(
    'This is a test email to me',
    html='<h1>Heading</h1><p>This is a paragraph</p>'
    )
    return this.success('email sent')

    :::

    The send_mail method sends emails from info@cloudomation.com to the email address of the user. On premise installations need to configure an SMTP server to use this feature. If none is configured cloudomation falls back to writing a file with the email contents in the directory declared by the environment variable "NOTIFICATION_PATH". The message will be displayed in the logs in case this is also unconfigured.

Learn More

Git Integration
Vault Integration
Connector Types