# Create Interaction

`lawmatics_create-interaction` · Lawmatics MCP tool · Interactions

Log an interaction (e.g. a phone call, meeting, or email) on a matter in Lawmatics. Provide the matter ID, the kind of interaction, when it happened, and a description. Returns the created interaction with a `relationships` envelope of {id,type} pointers to the owning record (matter/prospect) and the user who created it.

## Input

- **matterId** `string` (required, pattern: ^\d+$) — ID of the matter to log this interaction on
- **interactionType** `string` (required) — Kind of interaction (free-form label, e.g. "Phone Call", "Meeting", "Email")
- **happenedAt** `string(date-time)` (required, pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z||([+-](?:[01]\d|2[0-3]):[0-5]\d)))$) — When the interaction occurred, as an ISO 8601 timestamp
- **body** `string` (required) — Text describing the interaction

## Output

- **id** `string` (required) — Lawmatics interaction ID
- **interactionType** `string` (required) — Kind of interaction (free-form label, e.g. "Phone Call", "Meeting")
- **body** `string` (required) — Text describing the interaction
- **happenedAt** `string` (required) — When the interaction occurred, as an ISO 8601 timestamp
- **createdAt** `string` (required) — When the interaction record was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the interaction record was last updated, as an ISO 8601 timestamp
- **relationships** `object` (required) — JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'prospect' -> get-matter, type 'user' -> get-user).
  - **interactable** `object | null` (required) — Pointer to the owning record this interaction is logged on (type 'prospect' is a matter); null when unset
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
  - **createdBy** `object | null` (required) — Pointer to the Lawmatics user (type 'user') who created the interaction; null when unattributed
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized