Webhooks / Create with AI

Create with AI

Send unstructured text and let Goliath's AI extract and create or update a contact.

POST …/contacts/create-with-ai

The recommended endpoint for messy or unstructured data — obituaries, scraped listings, form submissions, notes. Goliath’s AI extracts name, phone, email, and address from the text and creates or updates the contact automatically.

This endpoint is asynchronous. It enqueues the work and returns immediately. The contact may not exist yet when you receive the response.

Request

POST {WEBHOOK_BASE_URL}/{token}/contacts/create-with-ai
Content-Type: application/json

{
  "unstructured_text": "John Doe passed away on January 1st. He lived at 123 Main St, Springfield. His daughter Jane can be reached at jane.doe@example.com or 555-000-0001.",
  "tags": ["probate", "springfield"],
  "source": "Obituary Scraper",
  "contributors": ["Sarah Smith"]
}

Body fields

Field	Type	Required	Description
`unstructured_text`	string or string[]	Yes	The raw text for AI extraction. Arrays are joined with newlines. Non-string items are dropped.
`full_name`	string	No	Overrides the AI-resolved name
`phone_number`	string	No	Overrides the AI-resolved phone
`contact_email`	string	No	Overrides the AI-resolved email
`contact_address`	string	No	Overrides the AI-resolved address
`note`	string	No	Additional context passed into the AI flow
`tags`	string[]	No	Applied to the contact after creation
`source`	string	No	Defaults to `Webhook` if omitted
`contributors`	string[]	No	Full names of org users to assign as contributors

Responses

New event

200 OK

{
  "success": true,
  "acknowledged": true,
  "eventId": "a1b2c3d4-0000-0000-0000-000000000000"
}

Duplicate event (same payload already received)

200 OK

{
  "success": true,
  "acknowledged": true
}

Deprecated alias

POST …/contacts/unstructured is a deprecated alias for this endpoint. It behaves identically but should not be used in new integrations.