Loading enrich_heyreach_email

enrich_heyreach_email

Find a LinkedIn profile's email address with HeyReach's paid enrichment: start a lookup, then poll its job until it completes.

# MCP tool reference

1 callable tools.

Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference.

Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result.

[Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt)

## enrich_heyreach_email

Find a LinkedIn profile's email address with HeyReach's paid enrichment: start a lookup, then poll its job until it completes.

Use when a lead has a LinkedIn profile but no email and the person wants one found. Start once, then poll the returned job id.

Each lookup spends the customer's HeyReach enrichment credit and is refused on a frozen subscription. The server deduplicates retries of the same lookup. `EMAIL_NOT_FOUND` is a finished answer, not a failure to retry.

Obtain the user's explicit authorization before invoking a write or destructive action. This is a client interaction requirement, not a server-issued approval token.

Scopes: integration:update, integration:read

Risk: costly; confirmation: explicit; idempotency: supported.

### Input schema (personal API key)

```json
{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "start"
          ]
        },
        "profileUrl": {
          "$ref": "#/$defs/LinkedInProfileUrl"
        }
      },
      "required": [
        "workspaceId",
        "action",
        "profileUrl"
      ],
      "patternProperties": {
        "^(?!(?:workspaceId|action|profileUrl)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "workspaceId",
          "action",
          "profileUrl"
        ]
      }
    },
    {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "status"
          ]
        },
        "jobId": {
          "$ref": "#/$defs/HeyReachId"
        }
      },
      "required": [
        "workspaceId",
        "action",
        "jobId"
      ],
      "patternProperties": {
        "^(?!(?:workspaceId|action|jobId)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "workspaceId",
          "action",
          "jobId"
        ]
      }
    }
  ],
  "$defs": {
    "LinkedInProfileUrl": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "HeyReachId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  }
}
```

### Input schema (OAuth / delegated agent)

```json
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "format": "uuid",
      "description": "Target Workspace UUID. Call list_workspaces to enumerate the Workspaces this credential may access, then pass the chosen id here."
    }
  },
  "required": [
    "workspaceId"
  ],
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "start"
          ]
        },
        "profileUrl": {
          "$ref": "#/$defs/LinkedInProfileUrl"
        }
      },
      "required": [
        "workspaceId",
        "action",
        "profileUrl"
      ],
      "patternProperties": {
        "^(?!(?:workspaceId)$)[\\s\\S]*?(?:^(?!(?:workspaceId|action|profileUrl)$)[\\s\\S]*$)": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "anyOf": [
          {
            "type": "string",
            "enum": [
              "workspaceId",
              "action",
              "profileUrl"
            ]
          },
          {
            "enum": [
              "workspaceId"
            ]
          }
        ]
      }
    },
    {
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "action": {
          "type": "string",
          "enum": [
            "status"
          ]
        },
        "jobId": {
          "$ref": "#/$defs/HeyReachId"
        }
      },
      "required": [
        "workspaceId",
        "action",
        "jobId"
      ],
      "patternProperties": {
        "^(?!(?:workspaceId)$)[\\s\\S]*?(?:^(?!(?:workspaceId|action|jobId)$)[\\s\\S]*$)": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "anyOf": [
          {
            "type": "string",
            "enum": [
              "workspaceId",
              "action",
              "jobId"
            ]
          },
          {
            "enum": [
              "workspaceId"
            ]
          }
        ]
      }
    }
  ],
  "$defs": {
    "LinkedInProfileUrl": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "HeyReachId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  }
}
```

### Output schema (structuredContent)

```json
{
  "$defs": {
    "HeyReachId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "HeyReachEnrichmentStarted": {
      "type": "object",
      "properties": {
        "jobId": {
          "$ref": "#/$defs/HeyReachId"
        }
      },
      "required": [
        "jobId"
      ],
      "patternProperties": {
        "^(?!(?:jobId)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "anyOf": [
          {
            "type": "string",
            "enum": [
              "jobId"
            ]
          }
        ]
      }
    },
    "HeyReachText": {
      "type": "string",
      "minLength": 0,
      "maxLength": 10000
    },
    "HeyReachEnrichmentJob": {
      "type": "object",
      "properties": {
        "jobId": {
          "$ref": "#/$defs/HeyReachId"
        },
        "status": {
          "type": "string",
          "enum": [
            "PENDING",
            "IN_PROGRESS",
            "COMPLETED",
            "FAILED"
          ]
        },
        "data": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "enum": [
                    "ENRICHED",
                    "EMAIL_NOT_FOUND",
                    "CANCELLED",
                    "FAILED"
                  ]
                },
                "message": {
                  "$ref": "#/$defs/HeyReachText"
                },
                "emailAddress": {
                  "anyOf": [
                    {
                      "$ref": "#/$defs/HeyReachText"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "memberId": {
                  "$ref": "#/$defs/HeyReachText"
                },
                "profileUrl": {
                  "$ref": "#/$defs/HeyReachText"
                }
              },
              "required": [
                "status",
                "message",
                "emailAddress",
                "memberId",
                "profileUrl"
              ],
              "patternProperties": {
                "^(?!(?:status|message|emailAddress|memberId|profileUrl)$)[\\s\\S]*$": false
              },
              "additionalProperties": true,
              "propertyNames": {
                "type": "string",
                "enum": [
                  "status",
                  "message",
                  "emailAddress",
                  "memberId",
                  "profileUrl"
                ]
              }
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "jobId",
        "status",
        "data"
      ],
      "patternProperties": {
        "^(?!(?:jobId|status|data)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "jobId",
          "status",
          "data"
        ]
      }
    }
  },
  "type": "object",
  "anyOf": [
    {
      "allOf": [
        {
          "anyOf": [
            {
              "$ref": "#/$defs/HeyReachEnrichmentStarted"
            },
            {
              "$ref": "#/$defs/HeyReachEnrichmentJob"
            }
          ]
        },
        {
          "type": "object"
        }
      ]
    },
    {
      "type": "object",
      "properties": {
        "data": {
          "allOf": [
            {
              "anyOf": [
                {
                  "$ref": "#/$defs/HeyReachEnrichmentStarted"
                },
                {
                  "$ref": "#/$defs/HeyReachEnrichmentJob"
                }
              ]
            },
            {
              "not": {
                "type": "object"
              }
            }
          ]
        }
      },
      "required": [
        "data"
      ],
      "additionalProperties": false
    }
  ]
}
```

### Underlying API operations

- `heyreachInsights.enrichEmail`: `POST /v1/workspaces/:workspaceId/integrations/heyreach/enrichment/email`
- `heyreachInsights.enrichStatus`: `GET /v1/workspaces/:workspaceId/integrations/heyreach/enrichment/:jobId`

Related MCP tools

add_heyreach_leads
Push up to 100 leads into a HeyReach campaign (optionally pinned to a sender) or a HeyReach list, and report how many were added, updated, or failed.
manage_heyreach_accounts
Maintain the workspace's LinkedIn sender accounts in HeyReach: reconnect a dropped session, re-read an account's state, choose how much of its inbox HeyReach scrapes, or remove it.
manage_heyreach_campaigns
Run the workspace's HeyReach LinkedIn campaigns: create one (from scratch or a template), change its settings, schedule, or action sequence, add, replace, or remove its senders, start, pause, or resume it, stop one lead, create a list, remove leads from a list, and set a lead's tags.
manage_heyreach_connection
Keep the workspace's HeyReach connection healthy: re-validate the stored key, restore the reply subscription native campaigns stop on, subscribe to or remove HeyReach webhook events, or disconnect HeyReach entirely.
message_heyreach
Reply in an existing LinkedIn conversation as one of the workspace's senders, or mark a conversation seen or unseen.
read_heyreach
Read the workspace's HeyReach LinkedIn automation as it is right now: the connection, sender accounts and their session status, campaigns with their sequences and enrolled leads, lists, lead tags, synced LinkedIn conversations, a sender's network, activity statistics, an email-enrichment job, and the webhook deliveries this workspace received.

See how this works in Scheduler Zero