# verify_contact (/docs/mcp/tools/verify-contact)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/verify_contact.mdx. */}

**Verify contact email** · Changes data · Acts outside your account · Spends credits or money

Checks whether the email of a saved contact is valid and deliverable. If the contact has no email but has a domain, it tries firstnamelastname@domain and firstname.lastname@domain. Pass the contactId returned by create_contact; a raw email is not accepted. For people from search_people use reveal_contact or find_contact_email instead. Needs the Email Waterfall add-on: without it the call returns 402 with an upgradeUrl. A valid or catch-all result can use a credit, and the call returns 400 'You do not have enough credits!' when credits run out. Confirm with the user before calling. Returns \{ email, phone, verificationStatus \} (e.g. valid, catch-all), or 404 'Contact Details not found' with email null.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `contactId` | `string` | Yes | The _id returned by create_contact (24 hex characters). |
| `websiteId` | `string` | Yes | Website ID from list_websites. Used for the credit check. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "verify_contact",
  "title": "Verify contact email",
  "annotations": {
    "title": "Verify contact email",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "contactId": {
        "type": "string",
        "description": "The _id returned by create_contact (24 hex characters)."
      },
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites. Used for the credit check."
      }
    },
    "required": [
      "contactId",
      "websiteId"
    ]
  }
}
```