Lawmatics
App · 25 actions
Run your law firm's intake in Lawmatics: add and update contacts and matters, move matters through your pipeline, book appointments, add tasks, notes and tags, record time and expenses, and start workflows when a contact or matter is added or changes stage.
Actions
| Action | What it does |
|---|---|
| Add company | Add a company, such as a business client. |
| Add contact | Add a person to Lawmatics. |
| Add event | Put an event, such as a consultation, on the firm's calendar, optionally for a matter or contact and with invites sent. |
| Add matter | Open a matter (a prospect) for an existing contact or company, or for a new contact made from the name, email and phone given. |
| Add note | Add a note to a matter, contact or company. |
| Add tags | Tag a matter, contact, company or task. |
| Add task | Add a task with a due date, optionally on a matter or contact and assigned to users. |
| Cancel event | Cancel an event, optionally telling its attendees. |
| Delete record | Delete a contact, matter, company, task, note, time entry or expense. |
| Find company | Look up a company by name, email address or phone number. |
| Find contact | Look up a contact by email address, phone number or name. |
| Find matter | Look up a matter by its contact's email address, phone number or name. |
| Get contact | Get one contact's details, with their matters and custom fields. |
| Get matter | Get one matter's details: its contact, stage, practice area, status, values and custom fields. |
| List contacts | List the firm's contacts, 25 at a time, optionally only those whose last name contains some text. |
| List events | List events (appointments), newest first, 25 at a time, optionally for one matter, contact or event type. |
| List invoices | List invoices, 25 at a time, with their status and what is still owed, optionally by status or for one matter. |
| List matters | List the firm's matters, 25 at a time, optionally in one stage, practice area, marketing source or status. |
| List tasks | List tasks, 25 at a time, optionally for one matter, contact or assignee, or only done or not done ones. |
| Record expense | Record an expense, such as a filing fee, on a matter. |
| Record time | Record time worked on a matter, finished so it can go on an invoice. |
| Remove tags | Take tags off a matter, contact, company or task. |
| Update contact | Change a contact's details. |
| Update matter | Change a matter, such as moving it to another stage or setting its status. |
| Update task | Change a task or mark it done. |
Add company
Add a company, such as a business client. Its name must be new to the firm.
Inputs
- Name
nametextRequired - The company's name.
- Email
emailtext - Its main email address.
- Phone
phonetext - Its main phone number.
- Street
streettext - The first line of the street address.
- Street line 2
street2text - Apartment, suite or unit.
- City
citytext - The city.
- State
statetext - The state or region.
- ZIP code
zipcodetext - The ZIP or postal code.
- Country
countrytext - The country.
Outputs
companyobject- The company
Example output
{
"company": {
"address": "128 White Water, Way, Elk Grove, CA 23422, United States",
"city": "Elk Grove",
"country": "United States",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "2",
"email": "info@example.com",
"id": "28",
"name": "Lawmatics Company",
"phone_number": "619-555-2855",
"state": "CA",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"zipcode": "23422"
}
}Add contact
Add a person to Lawmatics. If your firm matches contacts by email and the email is already on a contact, that contact is updated instead.
Inputs
- First name
first_nametextRequired - Their first name.
- Last name
last_nametext - Their last name.
- Middle name
middle_nametext - Their middle name.
- Email
emailtext - Their email address.
- Phone
phonetext - Their phone number.
- Date of birth
birthdatedate - Their date of birth.
- Employer
employertext - Where they work.
- Occupation
occupationtext - What they do.
- Title
titletext - A title, such as Esq. or Dr.
- Street
streettext - The first line of the street address.
- Street line 2
street2text - Apartment, suite or unit.
- City
citytext - The city.
- State
statetext - The state or region.
- ZIP code
zipcodetext - The ZIP or postal code.
- Country
countrytext - The country.
- Tags
tagslist - Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
- Custom fields
custom_fieldsobject - Values for the firm's custom contact fields. Leave a field empty to leave it as it is.
Outputs
contactobject- The contact
Example output
{
"contact": {
"birthdate": null,
"company_id": null,
"contact_type": "PNC",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "15",
"custom_fields": [
{
"field_type": "string",
"formatted_value": "Met at conference",
"id": 4788,
"name": "Referral notes",
"value": "Met at conference"
}
],
"date_of_last_contact": "2026-11-02T10:32:50.009-08:00",
"email": "gregor@clegane.com",
"employer": null,
"first_name": "Gregor",
"gender": null,
"id": "161257",
"last_name": "Clegane",
"marital_status": null,
"middle_name": null,
"occupation": null,
"phone": "520-730-1042",
"prospects_ids": [
"6446448"
],
"timezone": null,
"title": null,
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Add event
Put an event, such as a consultation, on the firm's calendar, optionally for a matter or contact and with invites sent.
Inputs
- Name
nametextRequired - The event's name.
- Event type
event_type_idtextRequired - The kind of event, such as Initial Consultation.
- Starts
startdate and timeRequired - When it starts.
- Ends
enddate and time - When it ends. Leave blank to use the event type's length.
- All day
all_daytrue/false - Turn on for an all-day event.
- Description
descriptiontext - Details of the event.
- Location
location_idtext - Where it takes place.
- Matter ID
matter_idtext - Put it on this matter (its id in Lawmatics). Fill in a matter or a contact, not both.
- Contact ID
contact_idtext - Put it on this contact (its id in Lawmatics). Fill in a matter or a contact, not both.
- Hosts
user_idslist - The users hosting it.
- Send invites
send_invitestrue/false - Turn on to email invites to the attendees.
Outputs
eventobject- The event
Example output
{
"event": {
"all_day": false,
"attendee_email": "jennifer1@gmail.com",
"attendee_name": "Jennifer Lee",
"canceled_at": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "API Appointment",
"end_date": "2026-11-20T15:30:00.000-08:00",
"event_type_id": "3",
"eventable_id": "6446448",
"eventable_type": "prospect",
"id": "13918",
"location_address": "1234 Miami, Miami, FL 12345, United States",
"location_name": "Miami Location",
"name": "Initial Consultation",
"send_invites": true,
"start_date": "2026-11-20T15:00:00.000-08:00",
"time_zone": "America/Los_Angeles",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
}Add matter
Open a matter (a prospect) for an existing contact or company, or for a new contact made from the name, email and phone given.
Inputs
- Contact ID
contact_idtext - An existing contact it is for. Leave blank to use a company or add a new contact.
- Company ID
company_idtext - An existing company it is for, instead of a contact.
- First name
first_nametext - For a new contact: their first name. Needed when no contact or company is given.
- Last name
last_nametext - For a new contact: their last name.
- Email
emailtext - For a new contact: their email address.
- Phone
phonetext - For a new contact: their phone number.
- Case title
case_titletext - The matter's title, such as Smith v. Jones.
- Case number
case_numbertext - The firm's number for it. It must be unique in the firm.
- Description
case_blurbtext - What the matter is about.
- Practice area
practice_area_idtext - The practice area, such as Estate Planning.
- Stage
stage_idtext - The pipeline stage it is in.
- Marketing source
source_idtext - Where the client came from.
- Status
sub_status_idtext - Its sub status, which also sets whether it is hired, a potential new client (PNC) or lost.
- Lead attorney
lead_attorney_idtext - Its lead attorney.
- Originating attorney
originating_attorney_idtext - The attorney who brought it in.
- Owner
owned_by_idtext - The user who owns it.
- Assigned staff
assigned_staff_idslist - Staff working on it.
- Estimated value
estimated_valuenumber - What it is expected to be worth, in dollars.At least 0.
- Actual value
actual_valuenumber - What it is worth, in dollars.At least 0.
- Tags
tagslist - Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
- Custom fields
custom_fieldsobject - Values for the firm's custom matter fields. Leave a field empty to leave it as it is.
Outputs
matterobject- The matter
Example output
{
"matter": {
"actual_value_cents": 0,
"campaign_id": null,
"case_blurb": "Client drank a glass of wine and it made him sick",
"case_number": "2026-CV-001",
"case_title": "Drank bad wine",
"company_id": null,
"contact_id": "161257",
"converted_date": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"custom_fields": [],
"email": "tyrion@small.com",
"estimated_value_cents": 250000,
"first_name": "Tyrion",
"id": "6446448",
"last_name": "Lannister",
"lead_attorney_id": "17",
"lead_cost_cents": 0,
"originating_attorney_id": null,
"owned_by_id": null,
"phone": "123-123-1234",
"practice_area_id": "3",
"source_id": "6",
"stage_id": "2",
"status": "pnc",
"statute_of_limitations": null,
"sub_status": "Pnc",
"tags_ids": [
"4"
],
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Add note
Add a note to a matter, contact or company.
Inputs
- Title
nametextRequired - The note's title.
- Note
bodytextRequired - What the note says.
- Matter ID
matter_idtext - Put it on this matter. Fill in one of matter, contact or company.
- Contact ID
contact_idtext - Put it on this contact. Fill in one of matter, contact or company.
- Company ID
company_idtext - Put it on this company. Fill in one of matter, contact or company.
Outputs
noteobject- The note
Example output
{
"note": {
"body": "An important thing to remember",
"created_at": "2026-11-02T10:32:50.009-08:00",
"id": "109",
"name": "Intake Note",
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Add tags
Tag a matter, contact, company or task. A tag name that doesn't exist yet is created.
Inputs
- Record type
record_typetextRequired - The kind of record to tag.One of:
matter,contact,company,task. - Record ID
record_idtextRequired - The record's id in Lawmatics.
- Tags
tagslistRequired - The tags to add. Pick existing ones or type new names.
Outputs
record_idtext- The record's id
record_typetext- The kind of record
tagslist- The tag names
Example output
{
"record_id": "6446448",
"record_type": "matter",
"tags": [
"VIP"
]
}Add task
Add a task with a due date, optionally on a matter or contact and assigned to users.
Inputs
- Name
nametextRequired - What the task is.
- Due date
due_datedateRequired - When it is due.
- Description
descriptiontext - What needs doing.
- Priority
prioritytext - How urgent it is.One of:
low,medium,high. - Task status
task_status_idtext - Its status, such as In Progress.
- Assigned to
user_idslist - The users it is assigned to.
- Matter ID
matter_idtext - Put it on this matter (its id in Lawmatics). Fill in a matter or a contact, not both.
- Contact ID
contact_idtext - Put it on this contact (its id in Lawmatics). Fill in a matter or a contact, not both.
Outputs
taskobject- The task
Example output
{
"task": {
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "Check on document status",
"done": false,
"due_date": "2026-11-25T00:00:00.000-08:00",
"id": "117",
"name": "Follow up with client",
"priority": "medium",
"status": "No Status",
"taskable_id": "6446448",
"taskable_type": "prospect",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
}Cancel event
Cancel an event, optionally telling its attendees.
Inputs
- Event ID
event_idtextRequired - The event's id in Lawmatics.
- Notify attendees
notify_attendeestrue/false - Turn on to send the attendees a cancellation notice.
Outputs
canceledtrue/false- True once it is canceled
eventobject- The canceled event
Example output
{
"canceled": true,
"event": {
"all_day": false,
"attendee_email": "jennifer1@gmail.com",
"attendee_name": "Jennifer Lee",
"canceled_at": "2026-11-04T10:00:00.000-08:00",
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "API Appointment",
"end_date": "2026-11-20T15:30:00.000-08:00",
"event_type_id": "3",
"eventable_id": "6446448",
"eventable_type": "prospect",
"id": "13918",
"location_address": "1234 Miami, Miami, FL 12345, United States",
"location_name": "Miami Location",
"name": "Initial Consultation",
"send_invites": true,
"start_date": "2026-11-20T15:00:00.000-08:00",
"time_zone": "America/Los_Angeles",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
}Delete record
Delete a contact, matter, company, task, note, time entry or expense. Deleting a contact or company also deletes its matters. This can't be undone.
Inputs
- Record type
record_typetextRequired - The kind of record to delete.One of:
contact,matter,company,task,note,time_entry(Time entry),expense. - Record ID
record_idtextRequired - The record's id in Lawmatics.
Outputs
deletedtrue/false- True once it is deleted
record_idtext- The deleted record's id
record_typetext- The kind of record
Example output
{
"deleted": true,
"record_id": "117",
"record_type": "task"
}Find company
Look up a company by name, email address or phone number. Says whether one was found rather than failing when none is.
Inputs
- Find by
find_bytextRequired - What to look them up by.One of:
email(Email address),phone(Phone number),name. - Value
valuetextRequired - The email address, phone number or name to look for.
Outputs
companyobject- The company, or empty when none was found
foundtrue/false- Whether a company was found
Example output
{
"company": {
"address": "128 White Water, Way, Elk Grove, CA 23422, United States",
"city": "Elk Grove",
"country": "United States",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "2",
"email": "info@example.com",
"id": "28",
"name": "Lawmatics Company",
"phone_number": "619-555-2855",
"state": "CA",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"zipcode": "23422"
},
"found": true
}Find contact
Look up a contact by email address, phone number or name. Says whether one was found rather than failing when none is.
Inputs
- Find by
find_bytextRequired - What to look them up by.One of:
email(Email address),phone(Phone number),name. - Value
valuetextRequired - The email address, phone number or name to look for.
Outputs
contactobject- The contact, or empty when none was found
foundtrue/false- Whether a contact was found
Example output
{
"contact": {
"birthdate": null,
"company_id": null,
"contact_type": "PNC",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "15",
"custom_fields": [
{
"field_type": "string",
"formatted_value": "Met at conference",
"id": 4788,
"name": "Referral notes",
"value": "Met at conference"
}
],
"date_of_last_contact": "2026-11-02T10:32:50.009-08:00",
"email": "gregor@clegane.com",
"employer": null,
"first_name": "Gregor",
"gender": null,
"id": "161257",
"last_name": "Clegane",
"marital_status": null,
"middle_name": null,
"occupation": null,
"phone": "520-730-1042",
"prospects_ids": [
"6446448"
],
"timezone": null,
"title": null,
"updated_at": "2026-11-03T09:12:41.198-08:00"
},
"found": true
}Find matter
Look up a matter by its contact's email address, phone number or name. Says whether one was found rather than failing when none is.
Inputs
- Find by
find_bytextRequired - What to look them up by.One of:
email(Email address),phone(Phone number),name. - Value
valuetextRequired - The email address, phone number or name to look for.
Outputs
foundtrue/false- Whether a matter was found
matterobject- The matter, or empty when none was found
Example output
{
"found": true,
"matter": {
"actual_value_cents": 0,
"campaign_id": null,
"case_blurb": "Client drank a glass of wine and it made him sick",
"case_number": "2026-CV-001",
"case_title": "Drank bad wine",
"company_id": null,
"contact_id": "161257",
"converted_date": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"custom_fields": [],
"email": "tyrion@small.com",
"estimated_value_cents": 250000,
"first_name": "Tyrion",
"id": "6446448",
"last_name": "Lannister",
"lead_attorney_id": "17",
"lead_cost_cents": 0,
"originating_attorney_id": null,
"owned_by_id": null,
"phone": "123-123-1234",
"practice_area_id": "3",
"source_id": "6",
"stage_id": "2",
"status": "pnc",
"statute_of_limitations": null,
"sub_status": "Pnc",
"tags_ids": [
"4"
],
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Get contact
Get one contact's details, with their matters and custom fields.
Inputs
- Contact ID
contact_idtextRequired - The contact's id in Lawmatics, from a trigger, 'Find contact' or another earlier step.
Outputs
contactobject- The contact
Example output
{
"contact": {
"birthdate": null,
"company_id": null,
"contact_type": "PNC",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "15",
"custom_fields": [
{
"field_type": "string",
"formatted_value": "Met at conference",
"id": 4788,
"name": "Referral notes",
"value": "Met at conference"
}
],
"date_of_last_contact": "2026-11-02T10:32:50.009-08:00",
"email": "gregor@clegane.com",
"employer": null,
"first_name": "Gregor",
"gender": null,
"id": "161257",
"last_name": "Clegane",
"marital_status": null,
"middle_name": null,
"occupation": null,
"phone": "520-730-1042",
"prospects_ids": [
"6446448"
],
"timezone": null,
"title": null,
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Get matter
Get one matter's details: its contact, stage, practice area, status, values and custom fields.
Inputs
- Matter ID
matter_idtextRequired - The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
Outputs
matterobject- The matter
Example output
{
"matter": {
"actual_value_cents": 0,
"campaign_id": null,
"case_blurb": "Client drank a glass of wine and it made him sick",
"case_number": "2026-CV-001",
"case_title": "Drank bad wine",
"company_id": null,
"contact_id": "161257",
"converted_date": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"custom_fields": [],
"email": "tyrion@small.com",
"estimated_value_cents": 250000,
"first_name": "Tyrion",
"id": "6446448",
"last_name": "Lannister",
"lead_attorney_id": "17",
"lead_cost_cents": 0,
"originating_attorney_id": null,
"owned_by_id": null,
"phone": "123-123-1234",
"practice_area_id": "3",
"source_id": "6",
"stage_id": "2",
"status": "pnc",
"statute_of_limitations": null,
"sub_status": "Pnc",
"tags_ids": [
"4"
],
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}List contacts
List the firm's contacts, 25 at a time, optionally only those whose last name contains some text.
Inputs
- Last name contains
last_nametext - Only contacts whose last name contains this. Leave blank for all.
- Order
sorttext - The order to list them in. Leave blank for newest first.One of:
newest(Newest added first),recently_changed(Recently changed first),oldest(Oldest added first). - Page
pagenumber - Which page of 25 to get. Leave blank for the first.At least 1.
Outputs
contactslist- The contacts on this page
countnumber- How many are on this page
has_moretrue/false- Whether there is another page
pagenumber- This page's number
total_entriesnumber- How many there are in all
total_pagesnumber- How many pages there are
Example output
{
"contacts": [
{
"birthdate": null,
"company_id": null,
"contact_type": "PNC",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "15",
"custom_fields": [
{
"field_type": "string",
"formatted_value": "Met at conference",
"id": 4788,
"name": "Referral notes",
"value": "Met at conference"
}
],
"date_of_last_contact": "2026-11-02T10:32:50.009-08:00",
"email": "gregor@clegane.com",
"employer": null,
"first_name": "Gregor",
"gender": null,
"id": "161257",
"last_name": "Clegane",
"marital_status": null,
"middle_name": null,
"occupation": null,
"phone": "520-730-1042",
"prospects_ids": [
"6446448"
],
"timezone": null,
"title": null,
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
],
"count": 1,
"has_more": false,
"page": 1,
"total_entries": 1,
"total_pages": 1
}List events
List events (appointments), newest first, 25 at a time, optionally for one matter, contact or event type. Use one filter at a time.
Inputs
- Matter ID
matter_idtext - Only events for this matter.
- Contact ID
contact_idtext - Only events for this contact.
- Event type
event_type_idtext - Only events of this type.
- Page
pagenumber - Which page of 25 to get. Leave blank for the first.At least 1.
Outputs
countnumber- How many are on this page
eventslist- The events on this page
has_moretrue/false- Whether there is another page
pagenumber- This page's number
total_entriesnumber- How many there are in all
total_pagesnumber- How many pages there are
Example output
{
"count": 1,
"events": [
{
"all_day": false,
"attendee_email": "jennifer1@gmail.com",
"attendee_name": "Jennifer Lee",
"canceled_at": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "API Appointment",
"end_date": "2026-11-20T15:30:00.000-08:00",
"event_type_id": "3",
"eventable_id": "6446448",
"eventable_type": "prospect",
"id": "13918",
"location_address": "1234 Miami, Miami, FL 12345, United States",
"location_name": "Miami Location",
"name": "Initial Consultation",
"send_invites": true,
"start_date": "2026-11-20T15:00:00.000-08:00",
"time_zone": "America/Los_Angeles",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
],
"has_more": false,
"page": 1,
"total_entries": 1,
"total_pages": 1
}List invoices
List invoices, 25 at a time, with their status and what is still owed, optionally by status or for one matter. Use one filter at a time.
Inputs
- Status
statustext - Only invoices with this status.One of:
draft,sending,sent,paid,partially_paid(Partially paid),past_due(Past due),forwarded,processing. - Matter ID
matter_idtext - Only invoices for this matter.
- Page
pagenumber - Which page of 25 to get. Leave blank for the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is another page
invoiceslist- The invoices on this page
pagenumber- This page's number
total_entriesnumber- How many there are in all
total_pagesnumber- How many pages there are
Example output
{
"count": 1,
"has_more": false,
"invoices": [
{
"amount_cents": 125000,
"amount_paid_cents": 0,
"contactable_name": "Roey Tester",
"created_at": "2026-11-02T10:32:50.009-08:00",
"due_at": "2026-11-16",
"id": "1",
"invoiced_at": "2026-11-02",
"note": "Thank you for your business.",
"number": 1,
"outstanding_amount_cents": 125000,
"payment_terms": "due_date",
"pdf_url": "https://lm.lawmatics.com/attachments/invoice-1.pdf",
"prospect_id": "6446448",
"status": "sent",
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
],
"page": 1,
"total_entries": 1,
"total_pages": 1
}List matters
List the firm's matters, 25 at a time, optionally in one stage, practice area, marketing source or status. Use one filter at a time.
Inputs
- Stage
stage_idtext - Only matters in this stage.
- Practice area
practice_area_idtext - Only matters in this practice area.
- Marketing source
source_idtext - Only matters from this source.
- Status
statustext - Only matters with this status.One of:
hired,pnc(Potential new client (PNC)),lost. - Order
sorttext - The order to list them in. Leave blank for newest first.One of:
newest(Newest added first),recently_changed(Recently changed first),oldest(Oldest added first). - Page
pagenumber - Which page of 25 to get. Leave blank for the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is another page
matterslist- The matters on this page
pagenumber- This page's number
total_entriesnumber- How many there are in all
total_pagesnumber- How many pages there are
Example output
{
"count": 1,
"has_more": false,
"matters": [
{
"actual_value_cents": 0,
"campaign_id": null,
"case_blurb": "Client drank a glass of wine and it made him sick",
"case_number": "2026-CV-001",
"case_title": "Drank bad wine",
"company_id": null,
"contact_id": "161257",
"converted_date": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"custom_fields": [],
"email": "tyrion@small.com",
"estimated_value_cents": 250000,
"first_name": "Tyrion",
"id": "6446448",
"last_name": "Lannister",
"lead_attorney_id": "17",
"lead_cost_cents": 0,
"originating_attorney_id": null,
"owned_by_id": null,
"phone": "123-123-1234",
"practice_area_id": "3",
"source_id": "6",
"stage_id": "2",
"status": "pnc",
"statute_of_limitations": null,
"sub_status": "Pnc",
"tags_ids": [
"4"
],
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
],
"page": 1,
"total_entries": 1,
"total_pages": 1
}List tasks
List tasks, 25 at a time, optionally for one matter, contact or assignee, or only done or not done ones. Use one filter at a time.
Inputs
- Matter ID
matter_idtext - Only tasks on this matter.
- Contact ID
contact_idtext - Only tasks on this contact.
- Assigned to
assignee_idtext - Only tasks assigned to this user.
- Done
statetext - Only tasks that are done, or only those that aren't.One of:
open(Not done),done. - Page
pagenumber - Which page of 25 to get. Leave blank for the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is another page
pagenumber- This page's number
taskslist- The tasks on this page
total_entriesnumber- How many there are in all
total_pagesnumber- How many pages there are
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"tasks": [
{
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "Check on document status",
"done": false,
"due_date": "2026-11-25T00:00:00.000-08:00",
"id": "117",
"name": "Follow up with client",
"priority": "medium",
"status": "No Status",
"taskable_id": "6446448",
"taskable_type": "prospect",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
],
"total_entries": 1,
"total_pages": 1
}Record expense
Record an expense, such as a filing fee, on a matter.
Inputs
- Matter ID
matter_idtextRequired - The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
- Staff member
staff_idtextRequired - Who the expense is for.
- Date
expensed_ondateRequired - The day of the expense.
- Cost
costnumberRequired - What it cost, in dollars.At least 0.
- Quantity
quantitynumber - How many, such as 2 copies. Leave blank for Lawmatics' default.At least 0.
- Description
descriptiontext - What it was for.
- Billable
billabletrue/false - Whether the client is billed for it.
Outputs
expenseobject- The expense
Example output
{
"expense": {
"activity_type_id": null,
"contactable_id": "6446448",
"contactable_type": "prospect",
"description": "Filing fee",
"duration": 0,
"id": "35",
"invoice_id": null,
"is_billable": true,
"is_flat_fee": false,
"staff_id": "2"
}
}Record time
Record time worked on a matter, finished so it can go on an invoice.
Inputs
- Matter ID
matter_idtextRequired - The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
- Staff member
staff_idtextRequired - Who did the work.
- Hours
hoursnumberRequired - How long it took, in hours, such as 1.5.At least 0.
- Started
worked_atdate and time - When the work started. Leave blank for now.
- Description
descriptiontext - What was done.
- Hourly rate
hourly_ratenumber - The rate in dollars an hour. Leave blank for the staff member's own rate.At least 0.
- Billable
billabletrue/false - Whether the client is billed for it.
Outputs
time_entryobject- The time entry
Example output
{
"time_entry": {
"activity_type_id": null,
"contactable_id": "6446448",
"contactable_type": "prospect",
"description": "Research Hours Billed",
"duration": 1.5,
"id": "34",
"invoice_id": null,
"is_billable": true,
"is_flat_fee": false,
"staff_id": "2"
}
}Remove tags
Take tags off a matter, contact, company or task. Tags it doesn't have are ignored.
Inputs
- Record type
record_typetextRequired - The kind of record to untag.One of:
matter,contact,company,task. - Record ID
record_idtextRequired - The record's id in Lawmatics.
- Tags
tagslistRequired - The tags to take off.
Outputs
record_idtext- The record's id
record_typetext- The kind of record
tagslist- The tag names
Example output
{
"record_id": "6446448",
"record_type": "matter",
"tags": [
"VIP"
]
}Update contact
Change a contact's details. Fields left blank keep their values.
Inputs
- Contact ID
contact_idtextRequired - The contact's id in Lawmatics, from a trigger, 'Find contact' or another earlier step.
- First name
first_nametext - A new first name.
- Last name
last_nametext - Their last name.
- Middle name
middle_nametext - Their middle name.
- Email
emailtext - Their email address.
- Phone
phonetext - Their phone number.
- Date of birth
birthdatedate - Their date of birth.
- Employer
employertext - Where they work.
- Occupation
occupationtext - What they do.
- Title
titletext - A title, such as Esq. or Dr.
- Street
streettext - The first line of the street address.
- Street line 2
street2text - Apartment, suite or unit.
- City
citytext - The city.
- State
statetext - The state or region.
- ZIP code
zipcodetext - The ZIP or postal code.
- Country
countrytext - The country.
- Tags
tagslist - Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
- Custom fields
custom_fieldsobject - Values for the firm's custom contact fields. Leave a field empty to leave it as it is.
Outputs
contactobject- The contact
Example output
{
"contact": {
"birthdate": null,
"company_id": null,
"contact_type": "PNC",
"created_at": "2026-11-02T10:32:50.009-08:00",
"created_by_id": "15",
"custom_fields": [
{
"field_type": "string",
"formatted_value": "Met at conference",
"id": 4788,
"name": "Referral notes",
"value": "Met at conference"
}
],
"date_of_last_contact": "2026-11-02T10:32:50.009-08:00",
"email": "gregor@clegane.com",
"employer": null,
"first_name": "Gregor",
"gender": null,
"id": "161257",
"last_name": "Clegane",
"marital_status": null,
"middle_name": null,
"occupation": null,
"phone": "520-730-1042",
"prospects_ids": [
"6446448"
],
"timezone": null,
"title": null,
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Update matter
Change a matter, such as moving it to another stage or setting its status. Fields left blank keep their values.
Inputs
- Matter ID
matter_idtextRequired - The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
- Case title
case_titletext - The matter's title, such as Smith v. Jones.
- Case number
case_numbertext - The firm's number for it. It must be unique in the firm.
- Description
case_blurbtext - What the matter is about.
- Practice area
practice_area_idtext - The practice area, such as Estate Planning.
- Stage
stage_idtext - The pipeline stage it is in.
- Marketing source
source_idtext - Where the client came from.
- Status
sub_status_idtext - Its sub status, which also sets whether it is hired, a potential new client (PNC) or lost.
- Lead attorney
lead_attorney_idtext - Its lead attorney.
- Originating attorney
originating_attorney_idtext - The attorney who brought it in.
- Owner
owned_by_idtext - The user who owns it.
- Assigned staff
assigned_staff_idslist - Staff working on it.
- Estimated value
estimated_valuenumber - What it is expected to be worth, in dollars.At least 0.
- Actual value
actual_valuenumber - What it is worth, in dollars.At least 0.
- Tags
tagslist - Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
- Custom fields
custom_fieldsobject - Values for the firm's custom matter fields. Leave a field empty to leave it as it is.
Outputs
matterobject- The matter
Example output
{
"matter": {
"actual_value_cents": 0,
"campaign_id": null,
"case_blurb": "Client drank a glass of wine and it made him sick",
"case_number": "2026-CV-001",
"case_title": "Drank bad wine",
"company_id": null,
"contact_id": "161257",
"converted_date": null,
"created_at": "2026-11-02T10:32:50.009-08:00",
"custom_fields": [],
"email": "tyrion@small.com",
"estimated_value_cents": 250000,
"first_name": "Tyrion",
"id": "6446448",
"last_name": "Lannister",
"lead_attorney_id": "17",
"lead_cost_cents": 0,
"originating_attorney_id": null,
"owned_by_id": null,
"phone": "123-123-1234",
"practice_area_id": "3",
"source_id": "6",
"stage_id": "2",
"status": "pnc",
"statute_of_limitations": null,
"sub_status": "Pnc",
"tags_ids": [
"4"
],
"updated_at": "2026-11-03T09:12:41.198-08:00"
}
}Update task
Change a task or mark it done. Fields left blank keep their values.
Inputs
- Task ID
task_idtextRequired - The task's id in Lawmatics.
- Done
statetext - Mark it done or not done. Leave blank to keep it as it is.One of:
open(Not done),done. - Name
nametext - A new name for the task.
- Due date
due_datedate - A new due date.
- Description
descriptiontext - What needs doing.
- Priority
prioritytext - How urgent it is.One of:
low,medium,high. - Task status
task_status_idtext - Its status, such as In Progress.
- Assigned to
user_idslist - The users it is assigned to.
Outputs
taskobject- The task
Example output
{
"task": {
"created_at": "2026-11-02T10:32:50.009-08:00",
"description": "Check on document status",
"done": true,
"due_date": "2026-11-25T00:00:00.000-08:00",
"id": "117",
"name": "Follow up with client",
"priority": "medium",
"status": "No Status",
"taskable_id": "6446448",
"taskable_type": "prospect",
"updated_at": "2026-11-03T09:12:41.198-08:00",
"users_ids": [
"2"
]
}
}