Bellwork
Start free
ContactsContactidGenerate email

Generate email for contact

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.

POST
/contacts/{contactId}/generate-email

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.

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

Request Body

application/json

template_id?string

Optional: pin a specific template. When omitted, the writer auto-picks among the org's active templates (or drafts untemplated if none fit/exist).

Match^([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|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
project_id?string

Project whose seller profile (company/ICP/territory) grounds the draft

Match^([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|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
extra_context?string

Free-text hint folded into the draft prompt (e.g. a specific angle to take)

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/v1/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08/generate-email" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "subject": "string",
    "body": "string",
    "template_id": "c6d67e98-83ea-49f0-8812-e4abae2b68bc"
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Find a missing contact field POST

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.

Search districts GET

Search and filter school districts. Returns NCES data plus extracted intelligence data for all results.