Leads To Email

Create Workflow from Domains

POST /v1/leads-to-email/domains

POST/v1/leads-to-email/domains
POST
/v1/leads-to-email/domains

Create a domains-only workflow: the server finds people at the given company domains, enriches them, and delivers the results to your webhook

Authorization

x-api-key<token>

API key for Open API authentication

In: header

Request Body

application/jsonRequired

domainsarray<string>

Company domains to enrich. Each entry is a bare domain/URL string or an object { domain, jobTitle?, department?, managementLevel?, decisionMaker? } whose criteria filter the people picked for THAT domain.

Example: ["saleshandy.com",{"domain":"stripe.com","jobTitle":"VP","department":"Marketing"}]

webhookUrlstring

Webhook URL that receives the final result once enrichment completes (single webhook with the enriched records).

Example: "https://example.com/webhooks/leads-to-email"

filtersobject

Search filters AND-combined onto every domain's people search — e.g. { "location": { "includes": ["United States"] } }.

exportColumnsarray<string>

Columns for the enriched output. Defaults to the key-columns set when omitted or empty.

leadsPerDomainnumber

How many people to enrich per domain (top-ranked by lead score). Defaults to 2 when omitted.

Default: 2Minimum: 1Maximum: 10

Responses

201
Workflow created. Returns the workflow id to track progress.
{
  "message": "Success",
  "payload": {
    "success": true,
    "id": "64f1a2b3c4d5e6f7a8b9c0d1",
    "status": "in_progress"
  }
}

Request

curl -X POST \
  "https://open-api.saleshandy.com/v1/leads-to-email/domains" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domains": [
    "saleshandy.com",
    {
      "domain": "stripe.com",
      "jobTitle": "VP",
      "department": "Marketing"
    }
  ],
  "webhookUrl": "https://example.com/webhooks/leads-to-email",
  "filters": {},
  "exportColumns": [
    "string"
  ],
  "leadsPerDomain": 0
}'

Response

No response body