> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goliathdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ContactCreateInput

> Request body for the create and create-with-ai inbound webhook endpoints.

Used in: [Create with AI](/inbound-create-with-ai), [Create Contact](/inbound-create)

***

## 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

```json theme={null}
{
  "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

<Warning>
  For `create-with-ai`: if `unstructured_text` is missing or empty after trimming, no contact is created even though the request returns `200`.
</Warning>

<Warning>
  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.
</Warning>

<Note>
  `first_name` and `last_name` are accepted but deprecated. Use `full_name` instead.
</Note>