# MyCase

> Run your law firm in MyCase: open and update cases, add people, companies and leads, put tasks and events on the calendar, add notes, record time and expenses, read invoices and documents, and start workflows when a case, person, lead, event, invoice or task changes.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/mycase

## Actions

### Add calendar event

Put an event, such as a hearing or consultation, on the firm's calendar for a staff member, optionally on a case.

**Inputs**

- Name (`name`, text, required): What the event is.
- Starts (`start`, date and time, required): When it starts.
- Ends (`end`, date and time, required): When it ends.
- Staff member (`staff_id`, text, required): The staff member whose calendar it goes on.
- Description (`description`, text): More about the event.
- Case ID (`case_id`, text): A case it is for: the case's id in MyCase, from 'List cases' or an earlier step.
- Location (`location_id`, text): Where it takes place.
- All day (`all_day`, true/false): Whether it lasts all day.
- Private (`private`, true/false): Whether only the staff on it can see it.

**Outputs**

- `event` (object): The event

**Example output**

```json
{
  "event": {
    "all_day": false,
    "case": {
      "id": 1024
    },
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Bring the signed contract.",
    "end": "2026-11-20T16:00:00Z",
    "event_type": "Meeting",
    "id": 300,
    "location": {
      "id": 4
    },
    "name": "Initial consultation",
    "private": false,
    "staff": [
      {
        "id": 12
      }
    ],
    "start": "2026-11-20T15:00:00Z",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Add company

Add a company to the firm's contacts, optionally with its people.

**Inputs**

- Name (`name`, text, required): The company's name.
- Email (`email`, text): The company's email address.
- Website (`website`, text): The company's website.
- Main phone (`main_phone_number`, text): Its main phone number.
- Fax (`fax_phone_number`, text): Its fax number.
- Notes (`notes`, text): Internal notes, seen by the firm but not by clients.
- People (`client_ids`, text): Ids of people who work there, separated by commas.
- Street address (`address1`, text): The first line of the street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- ZIP code (`zip_code`, text): The ZIP or postal code.
- Country (`country`, text): The country.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "company": {
    "address": {
      "address1": "100 Main St",
      "address2": "Suite 4",
      "city": "Austin",
      "country": "US",
      "state": "TX",
      "zip_code": "78701"
    },
    "archived": false,
    "cases": [
      {
        "id": 1024
      }
    ],
    "clients": [],
    "created_at": "2026-11-02T15:04:11Z",
    "email": "office@jonesconstruction.example.com",
    "fax_phone_number": null,
    "id": 512,
    "main_phone_number": "512-555-0100",
    "name": "Jones Construction LLC",
    "notes": null,
    "updated_at": "2026-11-03T09:12:40Z",
    "website": "https://jonesconstruction.example.com"
  }
}
```

### Add lead

Add a lead: someone asking the firm to take on their matter, such as a website enquiry.

**Inputs**

- First name (`first_name`, text, required): Their first name.
- Last name (`last_name`, text, required): Their last name.
- Email (`email`, text): Their email address.
- Cell phone (`cell_phone_number`, text): Their cell phone number.
- Work phone (`work_phone_number`, text): Their work phone number.
- Home phone (`home_phone_number`, text): Their home phone number.
- Details (`lead_details`, text): What they said about their matter, seen by the firm only.
- Date of birth (`birthdate`, date): Their date of birth.
- Referral source (`referral_source_id`, text): Where the lead came from, such as Website or Referral.
- Referred by (`referred_by_id`, text): The id of the person or company in MyCase who referred them.
- Street address (`address1`, text): The first line of the street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- ZIP code (`zip_code`, text): The ZIP or postal code.
- Country (`country`, text): The country.

**Outputs**

- `lead` (object): The lead

**Example output**

```json
{
  "lead": {
    "address": {
      "address1": "100 Main St",
      "address2": "Suite 4",
      "city": "Austin",
      "country": "US",
      "state": "TX",
      "zip_code": "78701"
    },
    "approved": false,
    "birthdate": null,
    "cell_phone_number": "512-555-0177",
    "created_at": "2026-11-02T15:04:11Z",
    "email": "riley.chen@example.com",
    "first_name": "Riley",
    "home_phone_number": null,
    "id": 4096,
    "last_name": "Chen",
    "lead_details": "Was rear-ended on I-35 last week and wants advice.",
    "referral_source_reference": {
      "id": 7
    },
    "referred_by": null,
    "status": "New",
    "updated_at": "2026-11-03T09:12:40Z",
    "work_phone_number": null
  }
}
```

### Add note

Add an internal note to a case, person or company.

**Inputs**

- Add it to (`record_type`, text, required): The kind of record the note goes on. One of: `case`, `client` (Person (client)), `company`.
- Record ID (`record_id`, text, required): The case's, person's or company's id in MyCase.
- Subject (`subject`, text, required): The note's subject.
- Note (`note`, text, required): What the note says.
- Date (`date`, date and time): The note's date. Leave blank for now.

**Outputs**

- `note` (object): The note

**Example output**

```json
{
  "note": {
    "archived": false,
    "case": {
      "id": 1024
    },
    "client": null,
    "company": null,
    "created_at": "2026-11-02T15:04:11Z",
    "created_by": {
      "id": 12
    },
    "date": "2026-11-03T09:12:40Z",
    "id": 77,
    "note": "Client confirmed the hearing date.",
    "subject": "Call with client",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Add person

Add a person (a client or other contact) to the firm, optionally on a case.

**Inputs**

- First name (`first_name`, text, required): Their first name.
- Last name (`last_name`, text, required): Their last name.
- Middle name (`middle_name`, text): Their middle name.
- Email (`email`, text): Their email address.
- Cell phone (`cell_phone_number`, text): Their cell phone number.
- Work phone (`work_phone_number`, text): Their work phone number.
- Home phone (`home_phone_number`, text): Their home phone number.
- Date of birth (`birthdate`, date): Their date of birth.
- Notes (`notes`, text): Internal notes about them, seen by the firm but not by them.
- People group (`people_group_id`, text): The people group to put them in, such as Clients or Opposing counsel.
- Case ID (`case_id`, text): A case to put them on: the case's id in MyCase, from 'List cases' or an earlier step.
- Street address (`address1`, text): The first line of the street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- ZIP code (`zip_code`, text): The ZIP or postal code.
- Country (`country`, text): The country.

**Outputs**

- `client` (object): The person

**Example output**

```json
{
  "client": {
    "address": {
      "address1": "100 Main St",
      "address2": "Suite 4",
      "city": "Austin",
      "country": "US",
      "state": "TX",
      "zip_code": "78701"
    },
    "archived": false,
    "birthdate": "1984-03-09",
    "cases": [
      {
        "id": 1024
      }
    ],
    "cell_phone_number": "512-555-0142",
    "created_at": "2026-11-02T15:04:11Z",
    "email": "jordan.smith@example.com",
    "first_name": "Jordan",
    "home_phone_number": null,
    "id": 2048,
    "last_name": "Smith",
    "middle_name": null,
    "notes": "Prefers email.",
    "people_group": {
      "id": 3
    },
    "updated_at": "2026-11-03T09:12:40Z",
    "work_phone_number": null
  }
}
```

### Add person to case

Link a person (client) to a case, with their role on it.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.
- Person ID (`client_id`, text, required): The person's id in MyCase, from 'Find people' or an earlier step.
- Role (`role`, text): Their role on the case, such as Client or Witness. A role the firm doesn't have yet is added.

**Outputs**

- `added` (true/false): True once they are linked
- `case_id` (number): The case's id
- `client_id` (number): The person's id

**Example output**

```json
{
  "added": true,
  "case_id": 1024,
  "client_id": 2048
}
```

### Add task

Give a staff member a to-do, due on a day, optionally on a case.

**Inputs**

- Task (`name`, text, required): What needs doing.
- Due date (`due_date`, date, required): The day it is due.
- Assigned to (`staff_id`, text, required): The staff member who does it.
- Priority (`priority`, text): How urgent it is. One of: `Low`, `Medium`, `High`. Default: `Medium`.
- Description (`description`, text): More about the task.
- Case ID (`case_id`, text): A case it is for: the case's id in MyCase, from 'List cases' or an earlier step.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "task": {
    "case": {
      "id": 1024
    },
    "completed": false,
    "completed_at": null,
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Use the firm's template.",
    "due_date": "2026-11-20",
    "id": 8192,
    "name": "Draft the complaint",
    "priority": "High",
    "staff": [
      {
        "id": 12
      }
    ],
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Delete record

Delete a case, person, company, task, calendar event, note, time entry or expense. This can't be undone.

**Inputs**

- Record type (`record_type`, text, required): The kind of record to delete. One of: `case`, `client` (Person (client)), `company`, `task`, `event` (Calendar event), `note`, `time_entry` (Time entry), `expense`.
- Record ID (`record_id`, text, required): The record's id in MyCase.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `record_id` (number): The deleted record's id
- `record_type` (text): The kind of record

**Example output**

```json
{
  "deleted": true,
  "record_id": 8192,
  "record_type": "task"
}
```

### Find companies

Find companies by name or email, or those changed since a time.

**Inputs**

- Name (`name`, text): Only the company with this name.
- Email (`email`, text): Only the company with this email address.
- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `companies` (list): The companies on this page
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "companies": [
    {
      "address": {
        "address1": "100 Main St",
        "address2": "Suite 4",
        "city": "Austin",
        "country": "US",
        "state": "TX",
        "zip_code": "78701"
      },
      "archived": false,
      "cases": [
        {
          "id": 1024
        }
      ],
      "clients": [],
      "created_at": "2026-11-02T15:04:11Z",
      "email": "office@jonesconstruction.example.com",
      "fax_phone_number": null,
      "id": 512,
      "main_phone_number": "512-555-0100",
      "name": "Jones Construction LLC",
      "notes": null,
      "updated_at": "2026-11-03T09:12:40Z",
      "website": "https://jonesconstruction.example.com"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page_token": ""
}
```

### Find leads

Find leads (prospective clients) by email, name or cell phone, or those changed since a time.

**Inputs**

- Email (`email`, text): Only the lead with this email address.
- First name (`first_name`, text): Only leads with this first name.
- Last name (`last_name`, text): Only leads with this last name.
- Cell phone (`cell_phone_number`, text): Only the lead with this cell phone number.
- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `leads` (list): The leads on this page
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "leads": [
    {
      "address": {
        "address1": "100 Main St",
        "address2": "Suite 4",
        "city": "Austin",
        "country": "US",
        "state": "TX",
        "zip_code": "78701"
      },
      "approved": false,
      "birthdate": null,
      "cell_phone_number": "512-555-0177",
      "created_at": "2026-11-02T15:04:11Z",
      "email": "riley.chen@example.com",
      "first_name": "Riley",
      "home_phone_number": null,
      "id": 4096,
      "last_name": "Chen",
      "lead_details": "Was rear-ended on I-35 last week and wants advice.",
      "referral_source_reference": {
        "id": 7
      },
      "referred_by": null,
      "status": "New",
      "updated_at": "2026-11-03T09:12:40Z",
      "work_phone_number": null
    }
  ],
  "next_page_token": ""
}
```

### Find people

Find people (MyCase's clients and other contacts) by email, name or cell phone, or those changed since a time.

**Inputs**

- Email (`email`, text): Only the person with this email address.
- First name (`first_name`, text): Only people with this first name.
- Last name (`last_name`, text): Only people with this last name.
- Cell phone (`cell_phone_number`, text): Only the person with this cell phone number.
- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `clients` (list): The people on this page
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "clients": [
    {
      "address": {
        "address1": "100 Main St",
        "address2": "Suite 4",
        "city": "Austin",
        "country": "US",
        "state": "TX",
        "zip_code": "78701"
      },
      "archived": false,
      "birthdate": "1984-03-09",
      "cases": [
        {
          "id": 1024
        }
      ],
      "cell_phone_number": "512-555-0142",
      "created_at": "2026-11-02T15:04:11Z",
      "email": "jordan.smith@example.com",
      "first_name": "Jordan",
      "home_phone_number": null,
      "id": 2048,
      "last_name": "Smith",
      "middle_name": null,
      "notes": "Prefers email.",
      "people_group": {
        "id": 3
      },
      "updated_at": "2026-11-03T09:12:40Z",
      "work_phone_number": null
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page_token": ""
}
```

### Get case

Get one case's details, with its people, companies and staff.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.

**Outputs**

- `case` (object): The case

**Example output**

```json
{
  "case": {
    "billing_contact": {
      "id": 2048
    },
    "billing_type": "hourly",
    "case_number": "2026-CV-0142",
    "case_stage": "Discovery",
    "clients": [
      {
        "id": 2048
      }
    ],
    "closed_date": null,
    "companies": [],
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Breach of contract over a kitchen remodel.",
    "id": 1024,
    "name": "Smith v. Jones",
    "opened_date": "2026-11-02",
    "outstanding_balance": 1250.0,
    "practice_area": "Civil Litigation",
    "sol_date": "2028-05-01",
    "staff": [
      {
        "id": 12
      }
    ],
    "status": "open",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Get person

Get one person's (client's) details, with their cases.

**Inputs**

- Person ID (`client_id`, text, required): The person's id in MyCase, from 'Find people' or an earlier step.

**Outputs**

- `client` (object): The person

**Example output**

```json
{
  "client": {
    "address": {
      "address1": "100 Main St",
      "address2": "Suite 4",
      "city": "Austin",
      "country": "US",
      "state": "TX",
      "zip_code": "78701"
    },
    "archived": false,
    "birthdate": "1984-03-09",
    "cases": [
      {
        "id": 1024
      }
    ],
    "cell_phone_number": "512-555-0142",
    "created_at": "2026-11-02T15:04:11Z",
    "email": "jordan.smith@example.com",
    "first_name": "Jordan",
    "home_phone_number": null,
    "id": 2048,
    "last_name": "Smith",
    "middle_name": null,
    "notes": "Prefers email.",
    "people_group": {
      "id": 3
    },
    "updated_at": "2026-11-03T09:12:40Z",
    "work_phone_number": null
  }
}
```

### List calendar events

List the firm's calendar events, optionally only those changed since a time.

**Inputs**

- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `events` (list): The events on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "all_day": false,
      "case": {
        "id": 1024
      },
      "created_at": "2026-11-02T15:04:11Z",
      "description": "Bring the signed contract.",
      "end": "2026-11-20T16:00:00Z",
      "event_type": "Meeting",
      "id": 300,
      "location": {
        "id": 4
      },
      "name": "Initial consultation",
      "private": false,
      "staff": [
        {
          "id": 12
        }
      ],
      "start": "2026-11-20T15:00:00Z",
      "updated_at": "2026-11-03T09:12:40Z"
    }
  ],
  "has_more": false,
  "next_page_token": ""
}
```

### List case documents

List the documents filed on a case, with their names and folders.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `documents` (list): The documents
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "assigned_date": "2026-11-02",
      "case": {
        "id": 1024
      },
      "created_at": "2026-11-02T15:04:11Z",
      "description": "Signed engagement letter.",
      "filename": "engagement-letter.pdf",
      "id": 5150,
      "name": "Engagement letter",
      "path": "Intake/Engagement letter",
      "self_url": "/v1/documents/5150",
      "updated_at": "2026-11-03T09:12:40Z"
    }
  ],
  "has_more": false,
  "next_page_token": ""
}
```

### List cases

List the firm's cases (matters), open, closed or both, optionally only those changed since a time.

**Inputs**

- Status (`status`, text): Only open or only closed cases. Leave blank for both. One of: `open`, `closed`.
- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `cases` (list): The cases on this page
- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "cases": [
    {
      "billing_contact": {
        "id": 2048
      },
      "billing_type": "hourly",
      "case_number": "2026-CV-0142",
      "case_stage": "Discovery",
      "clients": [
        {
          "id": 2048
        }
      ],
      "closed_date": null,
      "companies": [],
      "created_at": "2026-11-02T15:04:11Z",
      "description": "Breach of contract over a kitchen remodel.",
      "id": 1024,
      "name": "Smith v. Jones",
      "opened_date": "2026-11-02",
      "outstanding_balance": 1250.0,
      "practice_area": "Civil Litigation",
      "sol_date": "2028-05-01",
      "staff": [
        {
          "id": 12
        }
      ],
      "status": "open",
      "updated_at": "2026-11-03T09:12:40Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_page_token": ""
}
```

### List invoices

List the firm's invoices with their status, total and what has been paid, optionally only those changed since a time.

**Inputs**

- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Payable online only (`online_payments_only`, true/false): Only invoices clients can pay online. Leave off for every invoice.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `invoices` (list): The invoices on this page
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "invoices": [
    {
      "allow_online_payments": true,
      "case": {
        "id": 1024
      },
      "created_at": "2026-11-02T15:04:11Z",
      "due_date": "2026-12-01",
      "id": 640,
      "invoice_date": "2026-11-01",
      "invoice_number": "1042",
      "paid_amount": 0.0,
      "status": "sent",
      "total_amount": 1250.0,
      "updated_at": "2026-11-03T09:12:40Z",
      "view_url": "https://example.mycase.com/invoices/640"
    }
  ],
  "next_page_token": ""
}
```

### List staff

List the firm's staff (lawyers, paralegals and other users), with their ids and hourly rates.

**Inputs**

- Status (`status`, text): Only active or only inactive staff. Leave blank for both. One of: `active`, `inactive`.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page
- `staff` (list): The staff on this page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page_token": "",
  "staff": [
    {
      "active": true,
      "cell_phone_number": "512-555-0199",
      "created_at": "2026-11-02T15:04:11Z",
      "default_hourly_rate": 250.0,
      "email": "alex@riveralaw.example.com",
      "first_name": "Alex",
      "id": 12,
      "last_name": "Rivera",
      "title": "Partner",
      "type": "Attorney",
      "updated_at": "2026-11-03T09:12:40Z",
      "work_phone_number": null
    }
  ]
}
```

### List tasks

List the firm's tasks, optionally only those changed since a time.

**Inputs**

- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page
- `tasks` (list): The tasks on this page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page_token": "",
  "tasks": [
    {
      "case": {
        "id": 1024
      },
      "completed": false,
      "completed_at": null,
      "created_at": "2026-11-02T15:04:11Z",
      "description": "Use the firm's template.",
      "due_date": "2026-11-20",
      "id": 8192,
      "name": "Draft the complaint",
      "priority": "High",
      "staff": [
        {
          "id": 12
        }
      ],
      "updated_at": "2026-11-03T09:12:40Z"
    }
  ]
}
```

### List time entries

List time entries, optionally only those changed since a time.

**Inputs**

- Changed since (`updated_after`, date and time): Only those added or changed at or after this time.
- Page size (`page_size`, number): How many to return, from 1 to 1,000. Leave blank for 50. From 1 to 1000.
- Page token (`page_token`, text): For the next page: the next_page_token an earlier run of this step gave. Leave blank for the first page.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether there is another page after this one
- `next_page_token` (text): Give this as Page token to get the next page; empty on the last page
- `time_entries` (list): The time entries on this page

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_page_token": "",
  "time_entries": [
    {
      "activity_name": "Research",
      "billable": true,
      "case": {
        "id": 1024
      },
      "created_at": "2026-11-02T15:04:11Z",
      "description": "Case law on implied warranties.",
      "entry_date": "2026-11-03",
      "flat_fee": false,
      "hours": 1.5,
      "id": 9001,
      "invoices": [],
      "rate": "250.0",
      "staff": {
        "id": 12
      },
      "updated_at": "2026-11-03T09:12:40Z"
    }
  ]
}
```

### Open case

Open a new case (matter), with its people, companies and lead lawyer. The name must be unique in the firm.

**Inputs**

- Case name (`name`, text, required): The case's name, such as Smith v. Jones. It must be unique.
- Case number (`case_number`, text): The firm's own number for the case.
- Opened on (`opened_date`, date): The day the case was opened.
- Practice area (`practice_area`, text): The case's practice area, as set up in MyCase.
- Case stage (`case_stage`, text): The stage the case is in, as set up in MyCase.
- Description (`description`, text): What the case is about.
- Statute of limitations (`sol_date`, date): The statute of limitations date.
- Status (`status`, text): Whether the case is open or closed. One of: `open`, `closed`.
- People (`client_ids`, text): Ids of the people (clients) on the case, separated by commas.
- Companies (`company_ids`, text): Ids of the companies on the case, separated by commas.
- Lead lawyer (`lead_lawyer_id`, text): The staff member who leads the case.
- Other staff (`staff_ids`, text): Ids of other staff on the case, separated by commas.

**Outputs**

- `case` (object): The case

**Example output**

```json
{
  "case": {
    "billing_contact": {
      "id": 2048
    },
    "billing_type": "hourly",
    "case_number": "2026-CV-0142",
    "case_stage": "Discovery",
    "clients": [
      {
        "id": 2048
      }
    ],
    "closed_date": null,
    "companies": [],
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Breach of contract over a kitchen remodel.",
    "id": 1024,
    "name": "Smith v. Jones",
    "opened_date": "2026-11-02",
    "outstanding_balance": 1250.0,
    "practice_area": "Civil Litigation",
    "sol_date": "2028-05-01",
    "staff": [
      {
        "id": 12
      }
    ],
    "status": "open",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Record expense

Record an expense on a case, such as a filing fee or mileage.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.
- Activity (`activity_name`, text, required): What the expense is, such as Filing fee. A new one is added to MyCase.
- Date (`entry_date`, date, required): The day of the expense.
- Cost (`cost`, number, required): What one unit cost, in dollars.
- Units (`units`, number): How many units. Leave blank for 1.
- Billable (`billable`, true/false): Whether the client is billed for it. Leave blank for yes.
- Description (`description`, text): More about it.
- Staff member (`staff_id`, text): Who spent it.

**Outputs**

- `expense` (object): The expense

**Example output**

```json
{
  "expense": {
    "activity_name": "Filing fee",
    "billable": true,
    "case": {
      "id": 1024
    },
    "cost": "350.0",
    "created_at": "2026-11-02T15:04:11Z",
    "description": "District court filing fee.",
    "entry_date": "2026-11-03",
    "id": 9101,
    "invoices": [],
    "staff": {
      "id": 12
    },
    "units": "1.0",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Record time

Record time a staff member spent on a case, at an hourly rate.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.
- Staff member (`staff_id`, text, required): Who did the work.
- Activity (`activity_name`, text, required): The billing activity, such as Research or Court appearance.
- Date (`entry_date`, date, required): The day the work was done.
- Hours (`hours`, number, required): How long it took, in hours, such as 1.5.
- Hourly rate (`rate`, number, required): The rate in dollars an hour.
- Description (`description`, text): What was done.
- Billable (`billable`, true/false): Whether the client is billed for it.
- Flat fee (`flat_fee`, true/false): Whether it is a flat fee rather than hourly.

**Outputs**

- `time_entry` (object): The time entry

**Example output**

```json
{
  "time_entry": {
    "activity_name": "Research",
    "billable": true,
    "case": {
      "id": 1024
    },
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Case law on implied warranties.",
    "entry_date": "2026-11-03",
    "flat_fee": false,
    "hours": 1.5,
    "id": 9001,
    "invoices": [],
    "rate": "250.0",
    "staff": {
      "id": 12
    },
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Update case

Change a case's details, such as its stage or status. Fields left blank stay as they are.

**Inputs**

- Case ID (`case_id`, text, required): The case's id in MyCase, from 'List cases' or an earlier step.
- Case name (`name`, text): A new name for the case.
- Case number (`case_number`, text): The firm's own number for the case.
- Opened on (`opened_date`, date): The day the case was opened.
- Practice area (`practice_area`, text): The case's practice area, as set up in MyCase.
- Case stage (`case_stage`, text): The stage the case is in, as set up in MyCase.
- Description (`description`, text): What the case is about.
- Statute of limitations (`sol_date`, date): The statute of limitations date.
- Status (`status`, text): Whether the case is open or closed. One of: `open`, `closed`.

**Outputs**

- `case` (object): The case

**Example output**

```json
{
  "case": {
    "billing_contact": {
      "id": 2048
    },
    "billing_type": "hourly",
    "case_number": "2026-CV-0142",
    "case_stage": "Discovery",
    "clients": [
      {
        "id": 2048
      }
    ],
    "closed_date": null,
    "companies": [],
    "created_at": "2026-11-02T15:04:11Z",
    "description": "Breach of contract over a kitchen remodel.",
    "id": 1024,
    "name": "Smith v. Jones",
    "opened_date": "2026-11-02",
    "outstanding_balance": 1250.0,
    "practice_area": "Civil Litigation",
    "sol_date": "2028-05-01",
    "staff": [
      {
        "id": 12
      }
    ],
    "status": "open",
    "updated_at": "2026-11-03T09:12:40Z"
  }
}
```

### Update person

Change a person's details. Fields left blank stay as they are.

**Inputs**

- Person ID (`client_id`, text, required): The person's id in MyCase, from 'Find people' or an earlier step.
- First name (`first_name`, text): A new first name.
- Last name (`last_name`, text): A new last name.
- Middle name (`middle_name`, text): Their middle name.
- Email (`email`, text): Their email address.
- Cell phone (`cell_phone_number`, text): Their cell phone number.
- Work phone (`work_phone_number`, text): Their work phone number.
- Home phone (`home_phone_number`, text): Their home phone number.
- Date of birth (`birthdate`, date): Their date of birth.
- Notes (`notes`, text): Internal notes about them, seen by the firm but not by them.
- People group (`people_group_id`, text): The people group to put them in, such as Clients or Opposing counsel.
- Street address (`address1`, text): The first line of the street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text): The city.
- State (`state`, text): The state or region.
- ZIP code (`zip_code`, text): The ZIP or postal code.
- Country (`country`, text): The country.

**Outputs**

- `client` (object): The person

**Example output**

```json
{
  "client": {
    "address": {
      "address1": "100 Main St",
      "address2": "Suite 4",
      "city": "Austin",
      "country": "US",
      "state": "TX",
      "zip_code": "78701"
    },
    "archived": false,
    "birthdate": "1984-03-09",
    "cases": [
      {
        "id": 1024
      }
    ],
    "cell_phone_number": "512-555-0142",
    "created_at": "2026-11-02T15:04:11Z",
    "email": "jordan.smith@example.com",
    "first_name": "Jordan",
    "home_phone_number": null,
    "id": 2048,
    "last_name": "Smith",
    "middle_name": null,
    "notes": "Prefers email.",
    "people_group": {
      "id": 3
    },
    "updated_at": "2026-11-03T09:12:40Z",
    "work_phone_number": null
  }
}
```
