Ocean.io icon

Ocean.io

Find, enrich, and reveal company and people data from Ocean.io

Reveal → Reveal Emails

AI-generated

Overview

This node operation initiates a request to reveal email addresses for people identified by Ocean person IDs. It does not return the emails immediately; instead, Ocean sends the results asynchronously to a specified webhook URL. This is useful in workflows where you have already found or enriched people data and want to obtain their email addresses later via a webhook callback.

Use Case Examples

  1. Use case: After performing a Search People or Enrich Person operation to get Ocean person IDs, use this node to request email addresses for those people. Set up a webhook URL and a Wait node to receive the revealed emails asynchronously.
  2. Example: Input Ocean person IDs from a previous node, specify the webhook URL (usually the workflow's resume URL), and trigger the reveal emails request. The Wait node will then capture the incoming email data when Ocean completes the process.

Properties

Name Meaning
Ocean Person IDs Person ID(s) from Search People or Enrich Person output. For one person, map the ID field from the previous node. For many, comma-separate IDs.
Webhook URL URL where Ocean sends the revealed email or phone. Typically set to the workflow's resume URL to receive results in the same workflow via a Wait node.

Output

JSON

  • id - The ID of the person for whom the email was revealed.
  • email - The revealed email address of the person.
  • status - Status of the reveal request or result.
  • webhookResponse - Response data sent by Ocean to the webhook URL when the reveal is complete.

Dependencies

  • Requires an API key credential for Ocean.io to authenticate requests.

Troubleshooting

  • Common issue: Not receiving emails immediately because Ocean sends results asynchronously to the webhook URL. Ensure the webhook URL is correctly set and a Wait node is configured to catch the webhook call.
  • Error: "The operation \"revealEmails\" is not known!" indicates an invalid operation parameter; verify the operation name is exactly "revealEmails".
  • If no Ocean person IDs are provided or they are incorrectly formatted, the request will fail. Ensure IDs are correctly mapped and comma-separated if multiple.

Links

Discussion