Create Event (lawmatics_create-event)
Create an event (appointment) in Lawmatics. Provide the name, start/end times, the hosting firm user IDs, the event type, and the ID of exactly one entity (matter or contact — companies cannot have appointments) the appointment is with. Optionally set a description, location, reminder, time zone, and invite behavior.
Tool Input
namestringrequired— Name/title of the event (appointment)
descriptionstring— Description of the event
startDatestring(date-time)required— When the event starts, as an ISO 8601 timestamp(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)))$)
endDatestring(date-time)required— When the event ends, as an ISO 8601 timestamp(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)))$)
userIdsarrayrequired— IDs of the firm users hosting the appointment; numeric strings(min items: 1)
[]string(pattern: ^\d+$)
matterIdstring— ID of the matter the appointment is with
contactIdstring— ID of the contact the appointment is with
eventTypeIdstringrequired— ID of the event type for this event; a numeric string(pattern: ^\d+$)
locationIdstring— ID of the firm location the event is held at; a numeric string(pattern: ^\d+$)
allDayboolean— Whether the event is an all-day event (default false)
reminderDelayLengthinteger— How many reminderType units before the event to send a reminder; provide together with reminderType(> 0)
reminderTypestring— Unit for the reminder delay; provide together with reminderDelayLength(enum: "minutes", "hours", "days", "weeks", "months")
sendInvitesboolean— Whether to send calendar invites to attendees (default true)
noShowboolean— Whether the appointment is marked as a no-show (default false)
timeZonestring— IANA tz identifier to schedule the event in (e.g. "America/Los_Angeles")
Tool Output
idstringrequired— Lawmatics event (appointment) ID
namestringrequired— Name/title of the event
descriptionstringnullrequired— Description of the event; null if unset
timeZonestringnullrequired— IANA tz identifier the event is scheduled in (e.g. "America/Los_Angeles"); null if unset
startDatestringnullrequired— When the event starts, as an ISO 8601 timestamp; null when the date has been cleared
endDatestringnullrequired— When the event ends, as an ISO 8601 timestamp; null when the date has been cleared
allDaybooleannullrequired— True when the event is an all-day event; null when never explicitly set (treat as not all-day)
reminderTypestringnullrequired— Unit for the reminder delay ("minutes", "hours", "days", "weeks", "months"); null when no reminder is configured
reminderDelayLengthnumbernullrequired— How many reminderType units before the event the reminder is sent; null when no reminder is configured
reminderSentbooleanrequired— True when the reminder has already been sent
locationobjectnullrequired— Firm location the event is held at; null when no location is set
idnumberrequired— Lawmatics event location ID
namestringrequired— Name of the event location
addressIdnumbernullrequired— ID of the address record for the location; null for virtual locations (e.g. a Zoom URL venue)
sendInvitesbooleannullrequired— Whether calendar invites are sent to attendees; null if unset
eventTypeIdnumberrequired— ID of the event type this event belongs to
canceledAtstringnullrequired— When the appointment was canceled, as an ISO 8601 timestamp; always null on a fresh create
createdAtstringnullrequired— When the event record was created, as an ISO 8601 timestamp; null when the API omits it on the create echo
updatedAtstringnullrequired— When the event record was last updated, as an ISO 8601 timestamp; null when the API omits it on the create echo
relationshipsobjectrequired— 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 'contact' -> get-contact, type 'user' -> get-user).
eventableobjectnullrequired— The matter/contact the appointment is with (type "prospect" for a matter, "contact"); null when the event is unattached
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— 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
eventTypeobjectnullrequired— Event type pointer; null when unset
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— 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
addressobjectnullrequired— Linked address-record pointer; null when none is linked
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— 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
locationobjectnullrequired— Firm location pointer; null when no location is set
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— 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
usersarrayrequired— Hosting/attending firm-user pointers; empty array if none
[]object
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference; resolve it by calling that resource's own tool
Related Tools