Bellwork
Start free
ContactsContactidFind

Find a missing contact field

Look up a single missing contact field (email, phone, or LinkedIn) using the same web-research path as enrichment columns, then persist it onto the contact on success. The endpoint atomically reserves AI capacity before research; clients never book spend separately.

POST
/contacts/{contactId}/find

Look up a single missing contact field (email, phone, or LinkedIn) using the same web-research path as enrichment columns, then persist it onto the contact on success. The endpoint atomically reserves AI capacity before research; clients never book spend separately.

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Path Parameters

contactId*string
Formatuuid

Header Parameters

Idempotency-Key?string

Reuse the same UUID when retrying a request whose response was lost.

Formatuuid

Request Body

application/json

field*string
Value in"email" | "phone" | "linkedin"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08/find" \  -H "Content-Type: application/json" \  -d '{    "field": "email"  }'
{
  "field": "email",
  "value": "string",
  "found": true
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "ALLOWANCE_EXHAUSTED",
  "message": "string",
  "renews_at": "2019-08-24T14:15:22Z"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Enrich contact data POST

Queue a LinkedIn enrichment job for a contact. Adds profile summary, key facts, photo.

Generate email for contact POST

Generate a personalized outreach email for a contact, synchronously — the draft is returned inline, not queued as a job. `template_id` is optional: pass one of the org's saved templates (see GET /org/email-templates) to mirror, or omit it to draft untemplated (the writer will still auto-pick among the org's active templates). Enterprise/internal plans only.