Leads

Search leads by email

Find leads across all of the workspace’s campaigns by email (or fragment), for dedupe and cross-campaign lookup. Returns up to 10 matches.

Requires one of the following scopes: leads:read, leads:all, all:read, all:all.

get/v1/leads/search

Request

  • Base URL: https://api.mailbeast.ai
  • URL: https://api.mailbeast.ai/v1/leads/search
  • Auth: HTTP bearer

Query parameters

emailstring required
Example:jane@acme.com

Email (or fragment) to search for. Case-insensitive.

Response

Example response

{
  "data": [
    {
      "id": "c9e5b1a3-7f24-4d80-a6b9-2e4f8c0d1a37",
      "email": "jane@acme.com",
      "firstName": "Jane",
      "lastName": "Doe",
      "campaignId": "a7d4e2f1-08b3-4c65-9e7a-1b2c3d4e5f60",
      "campaignName": "Q4 Product Launch Outreach"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.