Fields
| Field | Type | Required | Description |
|---|---|---|---|
unstructured_text | string or string[] | Required for create-with-ai | Raw text for AI extraction. Arrays are joined with newlines. |
full_name | string | No | Contact’s full name. On create-with-ai, overrides the AI-resolved name. |
phone_number | string | No | Contact’s phone number |
contact_email | string | No | Contact’s email address |
contact_address | string | No | Contact’s address |
note | string | No | Additional context. On create-with-ai, passed into the AI flow. On create, creates a note on the contact. |
tags | string[] | No | Applied to the contact after creation |
source | string | No | Attribution source. Defaults to Webhook if omitted. |
contributors | string[] | No | Full names of org users to assign as contributors |
Example
{
"unstructured_text": "John Doe passed away January 1st. His daughter Jane can be reached at 555-000-0001.",
"full_name": "John Doe",
"tags": ["probate"],
"source": "Obituary Scraper",
"contributors": ["Sarah Smith"]
}
Notes
For
create-with-ai: if unstructured_text is missing or empty after trimming, no contact is created even though the request returns 200.For
create: at least one of full_name, phone_number, or contact_email must be present. If none are provided the request is accepted but no contact is created.first_name and last_name are accepted but deprecated. Use full_name instead.