Copy page

Automation

Pipedream

The Tomba app on Pipedream provides 20 actions and a connected account you can use in code steps. Pipedream maintains the app in its component registry (source); it's listed at pipedream.com/apps/tomba.

Prerequisites

• A Tomba API key and secret. See Get your key and secret.
• A Pipedream account.

Install and connect

1. In a workflow, add a step and search for Tomba.
2. Choose an action, or a Node.js code step that uses the Tomba app.
3. Connect your Tomba account with your API key and secret.

The app has no triggers. Start the workflow with an HTTP request, a schedule, or another app's event.

Actions

Each action sends one request, so it's charged and throttled like a direct API call: see Credit costs and Rate limits.

Check two actions before you rely on them:

• Validate Phone sends Country as a country parameter, which the API ignores. Write the number with its + country prefix instead.
• Find Phone searches by domain unless you change Search Type. A domain search is charged differently from an email or LinkedIn search; see Credit costs.

Example

Verify the email address posted to a workflow's HTTP trigger, in a Node.js code step. The tomba prop connects your Tomba account; its key and secret are available as this.tomba.$auth.api_key and this.tomba.$auth.api_secret.

Code
import { axios } from "@pipedream/platform";

export default defineComponent({
    props: {
        tomba: {
            type: "app",
            app: "tomba",
        },
    },
    async run({ steps, $ }) {
        const email = steps.trigger.event.body?.email;
        if (!email) {
            return $.flow.exit("No email in the request body");
        }

        const response = await axios($, {
            url: "https://api.tomba.io/v1/email-verifier",
            params: { email },
            headers: {
                "X-Tomba-Key": this.tomba.$auth.api_key,
                "X-Tomba-Secret": this.tomba.$auth.api_secret,
            },
            timeout: 180000,
        });

        return {
            email,
            result: response.data.email.result,
            status: response.data.email.status,
        };
    },
});

axios from @pipedream/platform returns the response body and throws on a non-2xx status. result is one of the result values.

Troubleshooting