Documentation

Integrate LeadCop.

Protect your registration forms and email lists from disposable, temporary, and fake email addresses. This guide covers everything from a simple no-code setup to full backend API integration.

Quick Start

The fastest way to protect your website — no programming needed. You just need to copy and paste one line of code.

3 steps to protect any website

  1. 1

    Create a free account

    Sign up — no credit card required. Your API key is generated automatically.

    Create free account →
  2. 2

    Copy the script tag

    Paste this snippet just before the closing </body> tag in your website's HTML:

    HTML
    <script
      src="https://leadcop.io/temp-email-validator.js"
      data-api-key="YOUR_API_KEY">
    </script>
  3. 3

    That's it — you're protected

    LeadCop automatically finds every email input field on your site. When someone types a disposable email, they'll see an error.

    ✅ Real-time validation as users type.

Using WordPress? Skip the code entirely — install the WordPress plugin and your forms are protected in under 2 minutes.

Authentication

Format your secret API key in the Authorization header for REST API requests.

HTTP Header
Authorization: Bearer YOUR_API_KEY

API Endpoint

POSThttps://leadcop.io/api/check-email

Request body

JSON
{
  "email": "test@mailinator.com"
}

Response

JSON
{
  "isDisposable": true,
  "domain": "mailinator.com",
  "requestsRemaining": 999
}

Integration Guides

HTML / Any Website

  1. 1

    Get your API key

    Create a free account and copy your API key from the dashboard.

  2. 2

    Paste one script tag

    Add the snippet just before the </body> closing tag in your website's HTML.

  3. 3

    You're done!

    LeadCop silently attaches to every email field and validates as users type.

HTML / Any Website
<!-- Paste just before the closing </body> tag -->
<!-- Works on any website — WordPress, Webflow, Squarespace, Shopify, etc. -->
<script
  src="https://leadcop.io/temp-email-validator.js"
  data-api-key="YOUR_API_KEY">
</script>

<!-- Optional: full configuration with all customization options -->
<script
  src="https://leadcop.io/temp-email-validator.js"
  data-api-key="YOUR_API_KEY"
  data-debounce="600"
  data-error-message="Disposable email addresses are not allowed."
  data-error-color="#ef4444"
  data-error-border="#f87171"
  data-warn-mx-message="This email domain has no mail server."
  data-warn-mx-color="#f59e0b"
  data-warn-mx-border="#fbbf24"
  data-warn-free-message="Free email providers are not accepted here."
  data-warn-free-color="#f59e0b"
  data-warn-free-border="#fbbf24">
</script>

Error Codes

200

OK

Request succeeded. Check the isDisposable field in the response.

400

Bad Request

The email field is missing or the value is not a valid email address format.

401

Unauthorized

No API key was provided, or the key is invalid. Include Authorization: Bearer YOUR_KEY in the request headers.

422

Unprocessable

The request body could not be parsed. Ensure you are sending valid JSON with Content-Type: application/json.

429

Too Many Requests

You have exceeded your plan's monthly request limit. Upgrade your plan or wait until the next reset.

5xx

Server Error

A temporary server error occurred. Your integration should fail open (allow the request through) and retry later.

Rate Limits

To ensure high availability and prevent abuse, LeadCop enforces rate limits across all subscription tiers.

Plan Tier
Monthly Credits
Rate Limit

FREE

1,000

1 REQ/SEC

BASIC

50,000

10 REQ/SEC

CUSTOM

Unlimited

100 REQ/SEC

Frequently Asked Questions

Protect your growth.

Set up takes under 2 minutes. Start for free today and clean your lead data instantly.

Start for free today