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

ActionWhat it does
Add companyAdd a company, such as a business client.
Add contactAdd a person to Lawmatics.
Add eventPut an event, such as a consultation, on the firm's calendar, optionally for a matter or contact and with invites sent.
Add matterOpen a matter (a prospect) for an existing contact or company, or for a new contact made from the name, email and phone given.
Add noteAdd a note to a matter, contact or company.
Add tagsTag a matter, contact, company or task.
Add taskAdd a task with a due date, optionally on a matter or contact and assigned to users.
Cancel eventCancel an event, optionally telling its attendees.
Delete recordDelete a contact, matter, company, task, note, time entry or expense.
Find companyLook up a company by name, email address or phone number.
Find contactLook up a contact by email address, phone number or name.
Find matterLook up a matter by its contact's email address, phone number or name.
Get contactGet one contact's details, with their matters and custom fields.
Get matterGet one matter's details: its contact, stage, practice area, status, values and custom fields.
List contactsList the firm's contacts, 25 at a time, optionally only those whose last name contains some text.
List eventsList events (appointments), newest first, 25 at a time, optionally for one matter, contact or event type.
List invoicesList invoices, 25 at a time, with their status and what is still owed, optionally by status or for one matter.
List mattersList the firm's matters, 25 at a time, optionally in one stage, practice area, marketing source or status.
List tasksList tasks, 25 at a time, optionally for one matter, contact or assignee, or only done or not done ones.
Record expenseRecord an expense, such as a filing fee, on a matter.
Record timeRecord time worked on a matter, finished so it can go on an invoice.
Remove tagsTake tags off a matter, contact, company or task.
Update contactChange a contact's details.
Update matterChange a matter, such as moving it to another stage or setting its status.
Update taskChange 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

NamenametextRequired
The company's name.
Emailemailtext
Its main email address.
Phonephonetext
Its main phone number.
Streetstreettext
The first line of the street address.
Street line 2street2text
Apartment, suite or unit.
Citycitytext
The city.
Statestatetext
The state or region.
ZIP codezipcodetext
The ZIP or postal code.
Countrycountrytext
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 namefirst_nametextRequired
Their first name.
Last namelast_nametext
Their last name.
Middle namemiddle_nametext
Their middle name.
Emailemailtext
Their email address.
Phonephonetext
Their phone number.
Date of birthbirthdatedate
Their date of birth.
Employeremployertext
Where they work.
Occupationoccupationtext
What they do.
Titletitletext
A title, such as Esq. or Dr.
Streetstreettext
The first line of the street address.
Street line 2street2text
Apartment, suite or unit.
Citycitytext
The city.
Statestatetext
The state or region.
ZIP codezipcodetext
The ZIP or postal code.
Countrycountrytext
The country.
Tagstagslist
Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
Custom fieldscustom_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

NamenametextRequired
The event's name.
Event typeevent_type_idtextRequired
The kind of event, such as Initial Consultation.
Startsstartdate and timeRequired
When it starts.
Endsenddate and time
When it ends. Leave blank to use the event type's length.
All dayall_daytrue/false
Turn on for an all-day event.
Descriptiondescriptiontext
Details of the event.
Locationlocation_idtext
Where it takes place.
Matter IDmatter_idtext
Put it on this matter (its id in Lawmatics). Fill in a matter or a contact, not both.
Contact IDcontact_idtext
Put it on this contact (its id in Lawmatics). Fill in a matter or a contact, not both.
Hostsuser_idslist
The users hosting it.
Send invitessend_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 IDcontact_idtext
An existing contact it is for. Leave blank to use a company or add a new contact.
Company IDcompany_idtext
An existing company it is for, instead of a contact.
First namefirst_nametext
For a new contact: their first name. Needed when no contact or company is given.
Last namelast_nametext
For a new contact: their last name.
Emailemailtext
For a new contact: their email address.
Phonephonetext
For a new contact: their phone number.
Case titlecase_titletext
The matter's title, such as Smith v. Jones.
Case numbercase_numbertext
The firm's number for it. It must be unique in the firm.
Descriptioncase_blurbtext
What the matter is about.
Practice areapractice_area_idtext
The practice area, such as Estate Planning.
Stagestage_idtext
The pipeline stage it is in.
Marketing sourcesource_idtext
Where the client came from.
Statussub_status_idtext
Its sub status, which also sets whether it is hired, a potential new client (PNC) or lost.
Lead attorneylead_attorney_idtext
Its lead attorney.
Originating attorneyoriginating_attorney_idtext
The attorney who brought it in.
Ownerowned_by_idtext
The user who owns it.
Assigned staffassigned_staff_idslist
Staff working on it.
Estimated valueestimated_valuenumber
What it is expected to be worth, in dollars.At least 0.
Actual valueactual_valuenumber
What it is worth, in dollars.At least 0.
Tagstagslist
Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
Custom fieldscustom_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

TitlenametextRequired
The note's title.
NotebodytextRequired
What the note says.
Matter IDmatter_idtext
Put it on this matter. Fill in one of matter, contact or company.
Contact IDcontact_idtext
Put it on this contact. Fill in one of matter, contact or company.
Company IDcompany_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 typerecord_typetextRequired
The kind of record to tag.One of: matter, contact, company, task.
Record IDrecord_idtextRequired
The record's id in Lawmatics.
TagstagslistRequired
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

NamenametextRequired
What the task is.
Due datedue_datedateRequired
When it is due.
Descriptiondescriptiontext
What needs doing.
Priorityprioritytext
How urgent it is.One of: low, medium, high.
Task statustask_status_idtext
Its status, such as In Progress.
Assigned touser_idslist
The users it is assigned to.
Matter IDmatter_idtext
Put it on this matter (its id in Lawmatics). Fill in a matter or a contact, not both.
Contact IDcontact_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 IDevent_idtextRequired
The event's id in Lawmatics.
Notify attendeesnotify_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 typerecord_typetextRequired
The kind of record to delete.One of: contact, matter, company, task, note, time_entry (Time entry), expense.
Record IDrecord_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 byfind_bytextRequired
What to look them up by.One of: email (Email address), phone (Phone number), name.
ValuevaluetextRequired
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 byfind_bytextRequired
What to look them up by.One of: email (Email address), phone (Phone number), name.
ValuevaluetextRequired
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 byfind_bytextRequired
What to look them up by.One of: email (Email address), phone (Phone number), name.
ValuevaluetextRequired
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 IDcontact_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 IDmatter_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 containslast_nametext
Only contacts whose last name contains this. Leave blank for all.
Ordersorttext
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).
Pagepagenumber
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 IDmatter_idtext
Only events for this matter.
Contact IDcontact_idtext
Only events for this contact.
Event typeevent_type_idtext
Only events of this type.
Pagepagenumber
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

Statusstatustext
Only invoices with this status.One of: draft, sending, sent, paid, partially_paid (Partially paid), past_due (Past due), forwarded, processing.
Matter IDmatter_idtext
Only invoices for this matter.
Pagepagenumber
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

Stagestage_idtext
Only matters in this stage.
Practice areapractice_area_idtext
Only matters in this practice area.
Marketing sourcesource_idtext
Only matters from this source.
Statusstatustext
Only matters with this status.One of: hired, pnc (Potential new client (PNC)), lost.
Ordersorttext
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).
Pagepagenumber
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 IDmatter_idtext
Only tasks on this matter.
Contact IDcontact_idtext
Only tasks on this contact.
Assigned toassignee_idtext
Only tasks assigned to this user.
Donestatetext
Only tasks that are done, or only those that aren't.One of: open (Not done), done.
Pagepagenumber
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 IDmatter_idtextRequired
The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
Staff memberstaff_idtextRequired
Who the expense is for.
Dateexpensed_ondateRequired
The day of the expense.
CostcostnumberRequired
What it cost, in dollars.At least 0.
Quantityquantitynumber
How many, such as 2 copies. Leave blank for Lawmatics' default.At least 0.
Descriptiondescriptiontext
What it was for.
Billablebillabletrue/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 IDmatter_idtextRequired
The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
Staff memberstaff_idtextRequired
Who did the work.
HourshoursnumberRequired
How long it took, in hours, such as 1.5.At least 0.
Startedworked_atdate and time
When the work started. Leave blank for now.
Descriptiondescriptiontext
What was done.
Hourly ratehourly_ratenumber
The rate in dollars an hour. Leave blank for the staff member's own rate.At least 0.
Billablebillabletrue/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 typerecord_typetextRequired
The kind of record to untag.One of: matter, contact, company, task.
Record IDrecord_idtextRequired
The record's id in Lawmatics.
TagstagslistRequired
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 IDcontact_idtextRequired
The contact's id in Lawmatics, from a trigger, 'Find contact' or another earlier step.
First namefirst_nametext
A new first name.
Last namelast_nametext
Their last name.
Middle namemiddle_nametext
Their middle name.
Emailemailtext
Their email address.
Phonephonetext
Their phone number.
Date of birthbirthdatedate
Their date of birth.
Employeremployertext
Where they work.
Occupationoccupationtext
What they do.
Titletitletext
A title, such as Esq. or Dr.
Streetstreettext
The first line of the street address.
Street line 2street2text
Apartment, suite or unit.
Citycitytext
The city.
Statestatetext
The state or region.
ZIP codezipcodetext
The ZIP or postal code.
Countrycountrytext
The country.
Tagstagslist
Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
Custom fieldscustom_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 IDmatter_idtextRequired
The matter's id in Lawmatics, from a trigger, 'Find matter' or another earlier step.
Case titlecase_titletext
The matter's title, such as Smith v. Jones.
Case numbercase_numbertext
The firm's number for it. It must be unique in the firm.
Descriptioncase_blurbtext
What the matter is about.
Practice areapractice_area_idtext
The practice area, such as Estate Planning.
Stagestage_idtext
The pipeline stage it is in.
Marketing sourcesource_idtext
Where the client came from.
Statussub_status_idtext
Its sub status, which also sets whether it is hired, a potential new client (PNC) or lost.
Lead attorneylead_attorney_idtext
Its lead attorney.
Originating attorneyoriginating_attorney_idtext
The attorney who brought it in.
Ownerowned_by_idtext
The user who owns it.
Assigned staffassigned_staff_idslist
Staff working on it.
Estimated valueestimated_valuenumber
What it is expected to be worth, in dollars.At least 0.
Actual valueactual_valuenumber
What it is worth, in dollars.At least 0.
Tagstagslist
Tags to add. Pick existing tags or type new ones; a new name makes a new tag.
Custom fieldscustom_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 IDtask_idtextRequired
The task's id in Lawmatics.
Donestatetext
Mark it done or not done. Leave blank to keep it as it is.One of: open (Not done), done.
Namenametext
A new name for the task.
Due datedue_datedate
A new due date.
Descriptiondescriptiontext
What needs doing.
Priorityprioritytext
How urgent it is.One of: low, medium, high.
Task statustask_status_idtext
Its status, such as In Progress.
Assigned touser_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"
    ]
  }
}

On this page