Skip to main content

Email Integration

Cloudomation 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

emailintegrationincoming emailincoming emailimap serverimap serverincoming email->imap serverCloudomationCloudomationimap server->Cloudomationimap connectorsmtp serversmtp serverCloudomation->smtp serversmtp connectoroutgoing internal emailoutgoing internal emailCloudomation->outgoing internal emailsmtp integrationoutgoing emailoutgoing emailsmtp server->outgoing email

Receiving Emails

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

info
Cloudomation 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 Cloudomation user accounts in your workspace. See send_mail().

    example
    To send an email to yourself:
    import flow_api
    def handler(system: flow_api.System, this: flow_api.Execution):
    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