# Submit Custom Form

`lawmatics_submit-custom-form` · Lawmatics MCP tool · Custom Forms

Submit an entry to a Lawmatics custom intake form, creating a Prospect (matter) or Contact record. Field values are sent as a map of form field ID to value; get the form's field IDs from lawmatics_get-custom-form first. Upstream, Lawmatics serves this endpoint without authentication (it powers public intake forms); this tool still calls it with the org's credentials and requires editor access.

## Input

- **customFormId** `string` (required, pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$) — UUID of the custom form to submit an entry to
- **fields** `object` (required) — Map of form field ID to the value to submit. Field IDs come from lawmatics_get-custom-form (rows[].components[].id): standard IDs (e.g. first_name), opaque custom-field IDs, or v2 IDs (e.g. custom_field_2263). Values are scalars; for list fields use a listOptions value
  - **[key: string]** `string | number | boolean`
- **utmSource** `string` — Optional source tracking value (the utm_source field)
- **utmCampaign** `string` — Optional campaign tracking value (the utm_campaign field)
- **referringUrl** `string(uri)` — Optional referring URL for tracking (the referring_url field)

## Output

- **id** `string` (required) — ID of the record the submission created
- **type** `string` (required, enum: "contact", "prospect") — Kind of record the submission created: "prospect" (a Lawmatics matter) or "contact"
- **firstName** `string | null` (required) — First name on the created record; null when the form did not set one
- **lastName** `string | null` (required) — Last name on the created record; null when the form did not set one
- **email** `string | null` (required) — Email address on the created record; null when the form did not set one
- **createdAt** `string` (required) — When the record was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the record was last updated, as an ISO 8601 timestamp