Email Finder: per-result callback

Webhook

POST

emailFinderResult

Your server receives this POST once for every lead in a batch finder job.
It fires as each lead is processed, letting you act on found emails immediately.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

Return any 2xx to acknowledge receipt

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://your-api-server.com' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "webhook:finder_lookup.completed",
    "timestamp": "2025-06-03T14:35:00.000Z",
    "data": {
        "job_id": "665b12cf3e4c9200138eaf10",
        "result_id": "emily.zhang@figma.com",
        "result": {
            "email": "emily.zhang@figma.com",
            "result": "found",
            "confidence": "high",
            "is_catch_all": false,
            "domain": "figma.com",
            "provider": "GOOGLE",
            "message": "Email found with high confidence"
        }
    }
}'

Modified at 2026-02-16 15:55:13

Email Validation: batch completion callback

Email Finder: batch completion callback