Email

00Overview

Manage Oracle Cloud Email Delivery straight from a flow — create sending domains, add DKIM signing keys and read back the CNAME records you need to publish, and register the approved senders your transactional mail goes out as. Curate the account-wide suppression list that blocks addresses you must not email, and move any domain or sender between compartments as an automated step. Every domain, sender, DKIM key and suppression can be created, fetched, listed and deleted without touching the console, and sending domains can be updated in place as well.

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Email

1. Sign in to the Oracle Cloud Console, open the Profile menu (the avatar at the top-right) and choose My profile.
2. In the node, set Authentication to either Connect Oracle Cloud — which reuses an Oracle Cloud account you have already connected to Flomation, chosen in the Oracle Cloud connection field — or API signing key (advanced) to supply a signing key by hand using the steps below.
3. For the advanced path, open API keys → Add API key under Resources, let Oracle Cloud generate a key pair and download the private key (a .pem file) — this is the signing key the node uses.
4. Oracle Cloud then shows a Configuration file preview; copy its values into the node: tenancy → Tenancy OCID, user → User OCID, fingerprint → Key Fingerprint, and region → Region (a plain region key such as uk-london-1).
5. For the Compartment OCID, open Identity & Security → Compartments and copy the compartment that holds your sending domains and senders — for suppression-list actions, use your tenancy OCID instead, as the suppression list is account-wide.
6. Store the downloaded private key as a Flomation environment secret (e.g. email_secret) and select it in the node's Private Key (PEM) field; if the key is passphrase-protected, add the passphrase as a secret too and pick it in Private Key Passphrase.

02Dkim

OCI Email: Create DKIM

oracle/email/dkim_create · Action

Create a DKIM signing key for an email domain. Optionally set the selector name — leave it blank to let OCI generate one. Returns a work-request id; poll Get DKIM until ACTIVE, then publish the CNAME record in DNS.

Returns: tool_result, dkim, id, lifecycle_state, work_request_id, success, error

OCI Email: Delete DKIM

oracle/email/dkim_delete · Action

Delete an Email Delivery DKIM signing key by its OCID, returning the work-request that tracks the teardown.

Returns: tool_result, id, work_request_id, success, error

OCI Email: Get DKIM

oracle/email/dkim_get · Action

Fetch a single Email Delivery DKIM signing key by its OCID — DNS subdomain, CNAME record value and lifecycle state.

Returns: tool_result, dkim, id, lifecycle_state, success, error

OCI Email: List DKIMs

oracle/email/dkim_list · Action

List the DKIM signing keys belonging to an email domain. Optionally filter by exact name or lifecycle state. Walks pagination up to a safe cap.

Returns: tool_result, dkims, count, truncated, success, error

03Email

OCI Email: Change Email Domain Compartment

oracle/email/email_domain_change_compartment · Action

Move an email sending domain into a different compartment — the domain keeps its OCID, only its compartment placement changes. Returns a work-request id to poll.

Returns: tool_result, id, work_request_id, success, error

OCI Email: Create Email Domain

oracle/email/email_domain_create · Action

Create an email sending domain in a compartment. Returns the domain plus a work-request id — poll Get Email Domain until ACTIVE.

Returns: tool_result, email_domain, id, lifecycle_state, work_request_id, success, error

OCI Email: Delete Email Domain

oracle/email/email_domain_delete · Action

Delete an email sending domain by its OCID — returns the work-request id tracking the teardown.

Returns: tool_result, id, work_request_id, success, error

OCI Email: Get Email Domain

oracle/email/email_domain_get · Action

Fetch a single Email Delivery sending domain by its OCID — its name, verification status, active DKIM key and lifecycle state.

Returns: tool_result, email_domain, id, lifecycle_state, success, error

OCI Email: List Email Domains

oracle/email/email_domain_list · Action

List the email (sending) domains in a compartment. Optionally filter by exact name or lifecycle state. Walks pagination up to a safe cap.

Returns: tool_result, email_domains, count, truncated, success, error

OCI Email: Update Email Domain

oracle/email/email_domain_update · Action

Partially update an Email Delivery sending domain's freeform tags — leave the tags blank to change nothing. Returns a work-request id, so poll the work request until it completes.

Returns: tool_result, id, work_request_id, success, error

04Sender

OCI Email: Change Sender Compartment

oracle/email/sender_change_compartment · Action

Move an approved sender into a different compartment — the sender keeps its OCID, only its compartment placement changes.

Returns: tool_result, id, destination_compartment_id, success, error

OCI Email: Create Sender

oracle/email/sender_create · Action

Register an approved sender — an envelope-from email address in a compartment that OCI Email Delivery will allow you to send mail as.

Returns: tool_result, sender, id, lifecycle_state, success, error

OCI Email: Delete Sender

oracle/email/sender_delete · Action

Delete an approved sender by its OCID so the address can no longer send mail.

Returns: tool_result, id, success, error

OCI Email: Get Sender

oracle/email/sender_get · Action

Fetch a single approved sender by its OCID — its email address, lifecycle state and email domain.

Returns: tool_result, sender, id, lifecycle_state, success, error

OCI Email: List Approved Senders

oracle/email/sender_list · Action

List the approved senders in a compartment. Optionally filter by email address, domain, or lifecycle state. Walks pagination up to a safe cap.

Returns: tool_result, senders, count, truncated, success, error

05Suppression

OCI Email: Create Suppression

oracle/email/suppression_create · Action

Add a recipient email address to the suppression list so Email Delivery will not send to it. Suppressions are customer-level, so the compartment must be the tenancy OCID. The reason is set by OCI (MANUAL for hand-added addresses) and returned on the result.

Returns: tool_result, suppression, id, success, error

OCI Email: Delete Suppression

oracle/email/suppression_delete · Action

Remove an address from the Email Delivery suppression list by its OCID so it can be mailed again.

Returns: tool_result, id, success, error

OCI Email: Get Suppression

oracle/email/suppression_get · Action

Fetch a single Email Delivery suppression-list entry by its OCID — the address, reason and suppression timestamps.

Returns: tool_result, suppression, id, success, error

OCI Email: List Suppressions

oracle/email/suppression_list · Action

List the addresses on a compartment's email suppression list. Optionally filter by exact email address or a creation-time window, and sort. Walks pagination up to a safe cap.

Returns: tool_result, suppressions, count, truncated, success, error

06Triggers

Email Trigger

trigger/email · Trigger

Triggers a flow when a new email arrives in a connected Gmail account

Returns: email_id, thread_id, from, to, subject, snippet, body_text, date, labels, has_attachments, account, triggered_at

07Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

• Suppression-list actions are account-wide, so their Compartment OCID must be the tenancy OCID rather than a child compartment, and any address you suppress is blocked across the whole tenancy.
• Creating or deleting a sending domain or DKIM key, moving a domain between compartments, and updating a domain all run asynchronously and return a work-request id, so wait for that work request to finish — polling the matching Get action until a newly created resource reads ACTIVE — before you rely on the result.
• A newly created DKIM key comes back in the CREATING state and returns a CNAME record you must publish in your domain's DNS before it can sign mail, so poll until the key reaches ACTIVE and then add that record at your DNS provider, where propagation is outside Oracle Cloud's control.
• Email Delivery is a regional service, so the Region you connect to determines which domains, senders and DKIM keys are visible, and resources created in another region will not appear.
• List actions walk at most 25 pages of results before stopping, so narrow large result sets with the available name, address, state or date filters rather than expecting a single call to return everything.