> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MoltSets

> Connect a MoltSets API key so Find data workflow steps can look up a person's email, mobile phone or LinkedIn URL.

## What This Integration Does

MoltSets is a data provider. Connecting it lets a workflow's [Find data step](https://docs.revyops.com/user-guide/workflows.md#find-data-step) look a person up and add the email, mobile phone or LinkedIn URL it finds to that person in RevyOps.

MoltSets is connected per workspace. Each workspace pastes its own MoltSets API key, and Find data steps for that workspace use it. Every lookup uses tokens from that MoltSets account.

> [!NOTE]
>
> MoltSets only appears on the Integrations page when Workflows access is switched on for your agency, because it is used by workflow steps only.
> A super admin can switch MoltSets off for an agency. Its tile then shows "Upgrade to Enterprise to Access" and Find data steps on MoltSets stop with "MoltSets is not available on your plan. Ask your agency admin."

## Setup

**1. Get an API key**

Sign in at **moltsets.com**, open **API keys** and create a key.

**2. Open the integration**

Go to **Settings → Integrations**, find the **Data Providers** section and open **MoltSets**.

**3. Save the key**

Paste the key and click **Save key**. RevyOps saves it, then checks it with MoltSets and shows **Key saved and checked.** If MoltSets refuses the key or can't be reached, the key is still saved and the panel says what went wrong.

The panel shows **API key connected** once a key is saved. Click **Remove**, then **Remove key** to confirm, to delete the key; Find data steps for that workspace then stop with "No MoltSets API key connected" until a key is saved again. Workspaces that are not live yet show **Incomplete** on their Find data workflows; a live workspace stays **Live** and its Find data steps fail until a key is saved. The **Connect MoltSets** link on a Find data step opens this panel directly.

## How A Person Is Looked Up

MoltSets finds a phone and the best email from a LinkedIn URL, so RevyOps starts from the person's LinkedIn URL. A person with none is looked up first by their email, or else by their first name, last name and company domain, which can also return a work email.

| What the step finds | Comes from |
| - | - |
| **LinkedIn URL** | The person's email, or their name and company domain |
| **Email** | The LinkedIn URL, or the name and company domain lookup |
| **Mobile phone** | The LinkedIn URL |

A person with no LinkedIn URL, no email and no name with a company domain can't be looked up, so nothing is found for them.

A LinkedIn URL or email found on the way to what the step looks for is added to the person too, even if the step wasn't asked for it: it is already paid for, and it is only looked for when the person has none.

## When MoltSets Says No

| MoltSets answer | What happens |
| - | - |
| The key is refused | The step fails with "MoltSets refused the API key. Reconnect MoltSets under Integrations." |
| No tokens left | The step fails and asks you to top up MoltSets, then rerun |
| The account is not active | The step fails and asks you to choose a plan in MoltSets |
| Phone lookups are not on your plan, or no phone tokens are left | The phone lookup is skipped and the rest of the step still runs. The run succeeds, and the step's result lists the phone as skipped with the reason |
| MoltSets rejects the input of a lookup | That lookup, and what depended on it, is skipped with the reason "MoltSets rejected the input"; the rest of the step still runs |
| Too many requests, or MoltSets is down | The step waits and tries again |

Values found before a failure are still added, so a retry with **Only if missing** on doesn't pay for the same lookups twice. Run History keeps every attempt's lookups, so you can see what the first attempt bought.

## Email Grades

MoltSets grades each email from A to F. The grade becomes the new email's status from MoltSets: **A** and **B** are Valid, **C** is Catchall, **F** or no grade is Unknown. A **D** email (a spam trap or do-not-mail address) is not added; the step's result lists it as skipped with its grade.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.