Icypeas Integration — ModuleX AI

Overview

Add Icypeas to any ModuleX agent or workflow. Find and verify professional email addresses against the Icypeas REST API (app.icypeas.com). Resolve a likely professional email from a person’s name and company domain, or check whether an existing address is valid and deliverable. Both operations run asynchronously: a job is submitted, then the result is fetched by polling.

Categories: Sales · Enrichment · Sales Engagement · Auth: API Key · Actions: 2

Authentication

API Key Authentication

Authenticate using your Icypeas API key

Step 1

Go to https://app.icypeas.com and sign up or log in

Step 2

Open the API settings / API access section in your account

Step 3

Create a new API key or copy your existing one

Step 4

Paste the API key below

Required Credentials

Field	Description	Required	Format
Icypeas API Key	Your Icypeas API key from app.icypeas.com	Yes	`-`

Available Actions

find_email — Find a professional email address from a first name, last name, and company domain or name. Submits the search and polls until a result is available.

Parameters

string

required

Target company domain (e.g. stripe.com) or company name (e.g. Stripe)

string

Target person’s first name

string

Target person’s last name

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "search_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Search Id"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "firstname": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Firstname"
    },
    "lastname": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lastname"
    },
    "item": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Item"
    }
  },
  "required": [
    "success"
  ],
  "title": "FindEmailOutput",
  "type": "object"
}

verify_email — Verify whether an email address is valid and deliverable. Submits the verification and polls until a result is available.

Parameters

string

required

Email address to verify (e.g. john@stripe.com)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "search_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Search Id"
    },
    "status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Status"
    },
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Email"
    },
    "valid": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Valid"
    },
    "item": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Item"
    }
  },
  "required": [
    "success"
  ],
  "title": "VerifyEmailOutput",
  "type": "object"
}

Limits & Quotas

Async polling: each call submits a job, then polls the read endpoint roughly every 3 seconds for up to 120 seconds. If the job does not reach a terminal status in that window, the call returns success=False with an explanatory error.
Terminal statuses: FOUND, DEBITED, NOT_FOUND, DEBITED_NOT_FOUND, BAD_INPUT, INSUFFICIENT_FUNDS, ABORTED. A clean no-match (NOT_FOUND) is still a successful run — email is simply null and, for verification, valid is false.
Rate limits: approximately 60 requests/minute.
Pricing (approx., per vendor pricing page): email finding ~1 credit per found email; email verification ~0.1 credit per check.
Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising. Plan for retries on the agent side based on the error string.

Using

Providers

Building

Tools

Icypeas Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Limits & Quotas

Enrow

Findymail

NeverBounce

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Enrow

Findymail

NeverBounce

​Links

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links