# Filevine

> Run your firm's cases in Filevine from workflows: open projects for new clients, keep contacts up to date, move cases through phases, and add notes, tasks, deadlines, documents and section details. Start a workflow when a project opens or changes phase, a contact changes, or a note, task, document or deadline is added.

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

## Actions

### Add comment

Reply to a note or task with a comment.

**Inputs**

- Note or task (`note`, text, required): The note or task's ID, from another Filevine step or the trigger.
- Comment (`body`, text, required): What the comment says.

**Outputs**

- `author_id` (text): The ID of the user who wrote it
- `author_name` (text): Their name
- `body` (text): What it says
- `created_at` (text): When it was written (ISO 8601)
- `id` (text): The comment's ID
- `note_id` (text): The note's ID
- `project_id` (text): The project's ID

**Example output**

```json
{
  "author_id": "300",
  "author_name": "Grace Hopper",
  "body": "Reviewed the attached documents.",
  "created_at": "2026-11-05T16:12:00Z",
  "id": "46774112",
  "note_id": "46774110",
  "project_id": "46774103"
}
```

### Add contact to project

Add a contact to a project, such as an adjuster or the other side, with their role on it.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Contact (`contact`, text, required): The contact's ID, from another Filevine step or the trigger.
- Role (`role`, text): Their role on the project, such as Defendant.

**Outputs**

- `contact_id` (text): The contact's ID
- `contact_name` (text): The contact's name
- `project_contact_id` (text): The ID of the contact's place on the project
- `project_id` (text): The project's ID
- `role` (text): Their role on the project

**Example output**

```json
{
  "contact_id": "46774104",
  "contact_name": "Charles Babbage",
  "project_contact_id": "88123460",
  "project_id": "46774103",
  "role": "Defendant"
}
```

### Add note

Add a note to a project's activity feed. Words starting with # become hashtags, and @username mentions someone.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Note (`body`, text, required): What the note says.
- Subject (`subject`, text): A subject line for the note.
- Pin to project (`pin_to_project`, true/false): Pin the note to the top of the project's feed.

**Outputs**

- `assignee_id` (text): For a task, the ID of the user it is given to
- `author_id` (text): The ID of the user who wrote it
- `body` (text): What it says
- `comment_count` (number): How many comments it has
- `completed_at` (text): When the task was done (ISO 8601)
- `completer_id` (text): The ID of the user who did it
- `created_at` (text): When it was written (ISO 8601)
- `due_date` (text): For a task, when it is due (YYYY-MM-DD)
- `id` (text): The note's or task's ID
- `is_completed` (true/false): True if the task is done
- `is_task` (true/false): True if it is a task
- `project_id` (text): The project's ID
- `subject` (text): Its subject
- `type` (text): Its kind as Filevine tags it, such as phcall for a phone call

**Example output**

```json
{
  "assignee_id": "",
  "author_id": "300",
  "body": "Discussed case strategy and next steps.",
  "comment_count": 0,
  "completed_at": "",
  "completer_id": "",
  "created_at": "2026-11-05T16:10:00Z",
  "due_date": "",
  "id": "46774110",
  "is_completed": false,
  "is_task": false,
  "project_id": "46774103",
  "subject": "Client intake call",
  "type": ""
}
```

### Archive project

Archive a project, such as when a case closes. It leaves the active list; people with access can still find it and restore it in Filevine.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.

**Outputs**

- `archived` (true/false): True once archived
- `id` (text): The project's ID

**Example output**

```json
{
  "archived": true,
  "id": "46774103"
}
```

### Change project phase

Move a project to another phase of its project type, such as from Intake to Treating.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Phase (`phase`, text, required): The phase to move it to.

**Outputs**

- `client_id` (text): The client contact's ID
- `client_name` (text): The client's name
- `contact_ids` (list): The IDs of the contacts on it
- `created_at` (text): When it was created (ISO 8601)
- `description` (text): Its description
- `first_primary_name` (text): The name of its first primary team member
- `hashtags` (list): Its hashtags
- `id` (text): The project's ID
- `incident_date` (text): The incident date (YYYY-MM-DD); empty if not set
- `is_archived` (true/false): True if it is archived
- `last_activity` (text): When anything last happened on it (ISO 8601)
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `name` (text): The project's name
- `number` (text): The project's number
- `phase_date` (text): When it entered that phase (ISO 8601)
- `phase_id` (text): The ID of the phase it is in
- `phase_name` (text): The phase it is in
- `previous_phase_id` (text): The ID of the phase it left
- `previous_phase_name` (text): The phase it left
- `project_email` (text): The project's own email address
- `project_type_id` (text): The ID of its project type
- `project_type_name` (text): Its project type, such as Personal Injury

**Example output**

```json
{
  "client_id": "46774102",
  "client_name": "Ada Lovelace",
  "contact_ids": [
    "46774102"
  ],
  "created_at": "2026-11-05T16:00:00Z",
  "description": "Rear-end collision on I-15.",
  "first_primary_name": "Grace Hopper",
  "hashtags": [
    "intake"
  ],
  "id": "46774103",
  "incident_date": "2026-10-31",
  "is_archived": false,
  "last_activity": "2026-11-05T16:05:00Z",
  "link": "https://example.com/#/project/46774103",
  "name": "Lovelace v. Babbage",
  "number": "PI-2026-0142",
  "phase_date": "2026-11-05T16:00:00Z",
  "phase_id": "88123458",
  "phase_name": "Treating",
  "previous_phase_id": "88123457",
  "previous_phase_name": "Intake",
  "project_email": "lovelace-v-babbage@example.com",
  "project_type_id": "88123456",
  "project_type_name": "Personal Injury"
}
```

### Complete task

Mark a task done.

**Inputs**

- Task (`task`, text, required): The task's ID, from another Filevine step or the trigger.

**Outputs**

- `assignee_id` (text): For a task, the ID of the user it is given to
- `author_id` (text): The ID of the user who wrote it
- `body` (text): What it says
- `comment_count` (number): How many comments it has
- `completed_at` (text): When the task was done (ISO 8601)
- `completer_id` (text): The ID of the user who did it
- `created_at` (text): When it was written (ISO 8601)
- `due_date` (text): For a task, when it is due (YYYY-MM-DD)
- `id` (text): The note's or task's ID
- `is_completed` (true/false): True if the task is done
- `is_task` (true/false): True if it is a task
- `project_id` (text): The project's ID
- `subject` (text): Its subject
- `type` (text): Its kind as Filevine tags it, such as phcall for a phone call

**Example output**

```json
{
  "assignee_id": "300",
  "author_id": "300",
  "body": "Review contract terms and flag any issues.",
  "comment_count": 0,
  "completed_at": "2026-11-06T09:00:00Z",
  "completer_id": "300",
  "created_at": "2026-11-05T16:10:00Z",
  "due_date": "2026-11-12",
  "id": "46774111",
  "is_completed": true,
  "is_task": true,
  "project_id": "46774103",
  "subject": "Contract review",
  "type": ""
}
```

### Create collection item

Add an item to a project's collection section, such as an insurance policy or a medical provider.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Section (`section`, text, required): The collection section, such as Insurance or Medical Providers.
- Fields (`fields`, object): The new item's fields and their values.

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `fields` (object): The item's values, keyed by field selector
- `id` (text): The item's ID
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `project_id` (text): The project's ID
- `section` (text): The section's selector
- `section_name` (text): The section's name

**Example output**

```json
{
  "created_at": "2026-11-05T16:30:00Z",
  "fields": {
    "coverageType": "Liability",
    "policyNumber": "PN-1234"
  },
  "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "link": "",
  "project_id": "46774103",
  "section": "insurance",
  "section_name": "Insurance"
}
```

### Create contact

Add a person to your org's contacts, such as a new client from an intake form, with their email, phone and address.

**Inputs**

- First name (`first_name`, text, required): Their first name.
- Middle name (`middle_name`, text): Their middle name.
- Last name (`last_name`, text): Their last name.
- Email (`email`, text): Their email address.
- Phone (`phone`, text): Their phone number, such as (801) 555-0134.
- Street (`street`, text): The first line of their address.
- Street line 2 (`street_2`, text): The second line, if any.
- City (`city`, text): Their city.
- State (`state`, text): Their state, such as UT.
- Postal code (`postal_code`, text): Their ZIP or postal code.
- Country (`country`, text): Their country.
- Birth date (`birth_date`, date): Their date of birth.
- Person types (`person_types`, list): What the contact is to your firm, such as Client or Adjuster. Filevine adds these to the ones they have; it never removes one.
- Job title (`job_title`, text): Their job title, such as Claims Adjuster.
- Company (`company`, text): The company they work for.

**Outputs**

- `address` (text): Their first address, on one line
- `birth_date` (text): Their birth date (YYYY-MM-DD); empty if not set
- `city` (text): That address's city
- `company` (text): The company they work for
- `email` (text): Their primary email
- `emails` (list): All their email addresses
- `first_name` (text): Their first name
- `full_name` (text): Their full name
- `hashtags` (list): Their hashtags
- `id` (text): The contact's ID
- `is_company` (true/false): True if the contact is a company
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `middle_name` (text): Their middle name
- `modified_at` (text): When the contact last changed (ISO 8601)
- `nickname` (text): Their nickname
- `person_types` (list): Their person types, such as Client or Adjuster
- `phone` (text): Their first phone number
- `phones` (list): All their phone numbers
- `postal_code` (text): That address's postal code
- `state` (text): That address's state

**Example output**

```json
{
  "address": "12 Main St, Salt Lake City, UT 84101",
  "birth_date": "1985-12-10",
  "city": "Salt Lake City",
  "company": "Analytical Engines",
  "email": "ada@example.com",
  "emails": [
    "ada@example.com"
  ],
  "first_name": "Ada",
  "full_name": "Ada Lovelace",
  "hashtags": [],
  "id": "46774102",
  "is_company": false,
  "job_title": "Engineer",
  "last_name": "Lovelace",
  "middle_name": "",
  "modified_at": "2026-11-05T16:00:00Z",
  "nickname": "",
  "person_types": [
    "Client"
  ],
  "phone": "(801) 555-0134",
  "phones": [
    "(801) 555-0134"
  ],
  "postal_code": "84101",
  "state": "UT"
}
```

### Create deadline

Add a deadline to a project, such as a statute of limitations or a filing date.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Name (`name`, text, required): What the deadline is, such as Statute of Limitations. At most 50 characters.
- Due (`due_date`, date): When it's due.
- Notes (`notes`, text): Anything to know about it.
- Done on (`done_date`, date): When it was met, if it already was.

**Outputs**

- `done_date` (text): When it was met (YYYY-MM-DD); empty if not yet
- `due_date` (text): When it is due (YYYY-MM-DD)
- `id` (text): The deadline's ID
- `name` (text): What the deadline is
- `notes` (text): Its notes
- `project_id` (text): The project's ID

**Example output**

```json
{
  "done_date": "",
  "due_date": "2028-10-31",
  "id": "67890",
  "name": "Statute of Limitations",
  "notes": "Two years from the incident.",
  "project_id": "46774103"
}
```

### Create project

Open a project (a case or matter) of a project type for a client contact. Add the contact first with 'Create contact'.

**Inputs**

- Project type (`project_type`, text, required): The kind of project, such as Personal Injury.
- Client (`client_contact`, text, required): The client contact's ID, from 'Create contact', 'Find contacts' or the trigger.
- Project name (`project_name`, text): What to call it. Leave blank for Filevine's name from the client.
- Number (`number`, text): The project's number, as your firm numbers them.
- Description (`description`, text): What the project is about.
- Incident date (`incident_date`, date): When the incident happened.
- Phase (`phase`, text): The phase it starts in. Leave blank for the first.

**Outputs**

- `client_id` (text): The client contact's ID
- `client_name` (text): The client's name
- `contact_ids` (list): The IDs of the contacts on it
- `created_at` (text): When it was created (ISO 8601)
- `description` (text): Its description
- `first_primary_name` (text): The name of its first primary team member
- `hashtags` (list): Its hashtags
- `id` (text): The project's ID
- `incident_date` (text): The incident date (YYYY-MM-DD); empty if not set
- `is_archived` (true/false): True if it is archived
- `last_activity` (text): When anything last happened on it (ISO 8601)
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `name` (text): The project's name
- `number` (text): The project's number
- `phase_date` (text): When it entered that phase (ISO 8601)
- `phase_id` (text): The ID of the phase it is in
- `phase_name` (text): The phase it is in
- `project_email` (text): The project's own email address
- `project_type_id` (text): The ID of its project type
- `project_type_name` (text): Its project type, such as Personal Injury

**Example output**

```json
{
  "client_id": "46774102",
  "client_name": "Ada Lovelace",
  "contact_ids": [
    "46774102"
  ],
  "created_at": "2026-11-05T16:00:00Z",
  "description": "Rear-end collision on I-15.",
  "first_primary_name": "Grace Hopper",
  "hashtags": [
    "intake"
  ],
  "id": "46774103",
  "incident_date": "2026-10-31",
  "is_archived": false,
  "last_activity": "2026-11-05T16:05:00Z",
  "link": "https://example.com/#/project/46774103",
  "name": "Lovelace v. Babbage",
  "number": "PI-2026-0142",
  "phase_date": "2026-11-05T16:00:00Z",
  "phase_id": "88123457",
  "phase_name": "Intake",
  "project_email": "lovelace-v-babbage@example.com",
  "project_type_id": "88123456",
  "project_type_name": "Personal Injury"
}
```

### Create task

Give someone a task on a project, due on a day. Left without an assignee, it goes to the connected Filevine user.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Task (`body`, text, required): What needs doing.
- Assignee (`assignee`, text): Who it's for, or their email. Leave blank for the connected Filevine user.
- Due (`due_date`, date): When it's due. Leave blank for today.
- Subject (`subject`, text): A short title for the task.

**Outputs**

- `assignee_id` (text): For a task, the ID of the user it is given to
- `author_id` (text): The ID of the user who wrote it
- `body` (text): What it says
- `comment_count` (number): How many comments it has
- `completed_at` (text): When the task was done (ISO 8601)
- `completer_id` (text): The ID of the user who did it
- `created_at` (text): When it was written (ISO 8601)
- `due_date` (text): For a task, when it is due (YYYY-MM-DD)
- `id` (text): The note's or task's ID
- `is_completed` (true/false): True if the task is done
- `is_task` (true/false): True if it is a task
- `project_id` (text): The project's ID
- `subject` (text): Its subject
- `type` (text): Its kind as Filevine tags it, such as phcall for a phone call

**Example output**

```json
{
  "assignee_id": "300",
  "author_id": "300",
  "body": "Review contract terms and flag any issues.",
  "comment_count": 0,
  "completed_at": "",
  "completer_id": "",
  "created_at": "2026-11-05T16:10:00Z",
  "due_date": "2026-11-12",
  "id": "46774111",
  "is_completed": false,
  "is_task": true,
  "project_id": "46774103",
  "subject": "Contract review",
  "type": ""
}
```

### Find contacts

Find contacts by words, name, email, phone or person type.

**Inputs**

- Search (`search`, text): Words to look for, such as a name.
- Full name (`full_name`, text): Their full name.
- Email (`email`, text): Their email address.
- Phone (`phone`, text): Their phone number.
- Person type (`person_type`, text): Only contacts of this type, such as Client.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**Outputs**

- `contacts` (list): The contacts found
- `count` (number): How many are listed
- `has_more` (true/false): True if there are more than are listed
- `total` (number): How many match in all

**Example output**

```json
{
  "contacts": [
    {
      "address": "12 Main St, Salt Lake City, UT 84101",
      "birth_date": "1985-12-10",
      "city": "Salt Lake City",
      "company": "Analytical Engines",
      "email": "ada@example.com",
      "emails": [
        "ada@example.com"
      ],
      "first_name": "Ada",
      "full_name": "Ada Lovelace",
      "hashtags": [],
      "id": "46774102",
      "is_company": false,
      "job_title": "Engineer",
      "last_name": "Lovelace",
      "middle_name": "",
      "modified_at": "2026-11-05T16:00:00Z",
      "nickname": "",
      "person_types": [
        "Client"
      ],
      "phone": "(801) 555-0134",
      "phones": [
        "(801) 555-0134"
      ],
      "postal_code": "84101",
      "state": "UT"
    }
  ],
  "count": 1,
  "has_more": false,
  "total": 1
}
```

### Find projects

Find projects (cases and matters) by words, name, number, phase or when they were opened. Leave every field blank to list the newest.

**Inputs**

- Search (`search`, text): Words to look for in the project's or client's name, such as Lovelace.
- Name (`name`, text): The project's name.
- Number (`number`, text): The project's number.
- Phase (`phase`, text): Only projects in this phase, such as Intake.
- Opened since (`created_since`, date): Only projects opened on or after this day.
- Include archived (`include_archived`, true/false): Also list archived projects.
- Order (`sort`, text): How to order them. Defaults to newest first. One of: `newest` (Newest first), `recent_activity` (Most recent activity first), `phase_changed` (Most recent phase change first), `name` (Name, A to Z).
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `has_more` (true/false): True if there are more than are listed
- `projects` (list): The projects found
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "projects": [
    {
      "client_id": "46774102",
      "client_name": "Ada Lovelace",
      "contact_ids": [
        "46774102"
      ],
      "created_at": "2026-11-05T16:00:00Z",
      "description": "Rear-end collision on I-15.",
      "first_primary_name": "Grace Hopper",
      "hashtags": [
        "intake"
      ],
      "id": "46774103",
      "incident_date": "2026-10-31",
      "is_archived": false,
      "last_activity": "2026-11-05T16:05:00Z",
      "link": "https://example.com/#/project/46774103",
      "name": "Lovelace v. Babbage",
      "number": "PI-2026-0142",
      "phase_date": "2026-11-05T16:00:00Z",
      "phase_id": "88123457",
      "phase_name": "Intake",
      "project_email": "lovelace-v-babbage@example.com",
      "project_type_id": "88123456",
      "project_type_name": "Personal Injury"
    }
  ],
  "total": 1
}
```

### Get contact

Get a contact's details: their emails, phones, address and person types.

**Inputs**

- Contact (`contact`, text, required): The contact's ID, from another Filevine step or the trigger.

**Outputs**

- `address` (text): Their first address, on one line
- `birth_date` (text): Their birth date (YYYY-MM-DD); empty if not set
- `city` (text): That address's city
- `company` (text): The company they work for
- `email` (text): Their primary email
- `emails` (list): All their email addresses
- `first_name` (text): Their first name
- `full_name` (text): Their full name
- `hashtags` (list): Their hashtags
- `id` (text): The contact's ID
- `is_company` (true/false): True if the contact is a company
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `middle_name` (text): Their middle name
- `modified_at` (text): When the contact last changed (ISO 8601)
- `nickname` (text): Their nickname
- `person_types` (list): Their person types, such as Client or Adjuster
- `phone` (text): Their first phone number
- `phones` (list): All their phone numbers
- `postal_code` (text): That address's postal code
- `state` (text): That address's state

**Example output**

```json
{
  "address": "12 Main St, Salt Lake City, UT 84101",
  "birth_date": "1985-12-10",
  "city": "Salt Lake City",
  "company": "Analytical Engines",
  "email": "ada@example.com",
  "emails": [
    "ada@example.com"
  ],
  "first_name": "Ada",
  "full_name": "Ada Lovelace",
  "hashtags": [],
  "id": "46774102",
  "is_company": false,
  "job_title": "Engineer",
  "last_name": "Lovelace",
  "middle_name": "",
  "modified_at": "2026-11-05T16:00:00Z",
  "nickname": "",
  "person_types": [
    "Client"
  ],
  "phone": "(801) 555-0134",
  "phones": [
    "(801) 555-0134"
  ],
  "postal_code": "84101",
  "state": "UT"
}
```

### Get document

Get a document's details and a link that downloads it, which works for an hour.

**Inputs**

- Document (`document`, text, required): The document's ID, from another Filevine step or the trigger.

**Outputs**

- `content_type` (text): The file's type, such as application/pdf
- `download_url` (text): A link that downloads the file, which works for an hour
- `filename` (text): Its file name, with its extension
- `folder_id` (text): The ID of the folder it is in
- `folder_name` (text): The folder it is in
- `hashtags` (list): Its hashtags
- `id` (text): The document's ID
- `project_id` (text): The project's ID
- `size` (number): Its size in bytes
- `uploaded_at` (text): When it was uploaded (ISO 8601)
- `uploader_id` (text): The ID of the user who uploaded it
- `uploader_name` (text): Their name

**Example output**

```json
{
  "content_type": "application/pdf",
  "download_url": "https://files.example.com/46774120/contract.pdf?signature=abc",
  "filename": "contract.pdf",
  "folder_id": "88123456",
  "folder_name": "Documents",
  "hashtags": [],
  "id": "46774120",
  "project_id": "46774103",
  "size": 102400,
  "uploaded_at": "2026-11-05T16:20:00Z",
  "uploader_id": "300",
  "uploader_name": "Grace Hopper"
}
```

### Get project

Get a project's details: its client, phase, type and dates, and the values of one of its form sections if you choose one.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Section (`section`, text): A form section to read too, such as Case Summary. Leave blank for the project's details only.

**Outputs**

- `client_id` (text): The client contact's ID
- `client_name` (text): The client's name
- `contact_ids` (list): The IDs of the contacts on it
- `created_at` (text): When it was created (ISO 8601)
- `description` (text): Its description
- `first_primary_name` (text): The name of its first primary team member
- `hashtags` (list): Its hashtags
- `id` (text): The project's ID
- `incident_date` (text): The incident date (YYYY-MM-DD); empty if not set
- `is_archived` (true/false): True if it is archived
- `last_activity` (text): When anything last happened on it (ISO 8601)
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `name` (text): The project's name
- `number` (text): The project's number
- `phase_date` (text): When it entered that phase (ISO 8601)
- `phase_id` (text): The ID of the phase it is in
- `phase_name` (text): The phase it is in
- `project_email` (text): The project's own email address
- `project_type_id` (text): The ID of its project type
- `project_type_name` (text): Its project type, such as Personal Injury
- `section_values` (object): The values of the form section you asked for, keyed by field selector; empty if you asked for none

**Example output**

```json
{
  "client_id": "46774102",
  "client_name": "Ada Lovelace",
  "contact_ids": [
    "46774102"
  ],
  "created_at": "2026-11-05T16:00:00Z",
  "description": "Rear-end collision on I-15.",
  "first_primary_name": "Grace Hopper",
  "hashtags": [
    "intake"
  ],
  "id": "46774103",
  "incident_date": "2026-10-31",
  "is_archived": false,
  "last_activity": "2026-11-05T16:05:00Z",
  "link": "https://example.com/#/project/46774103",
  "name": "Lovelace v. Babbage",
  "number": "PI-2026-0142",
  "phase_date": "2026-11-05T16:00:00Z",
  "phase_id": "88123457",
  "phase_name": "Intake",
  "project_email": "lovelace-v-babbage@example.com",
  "project_type_id": "88123456",
  "project_type_name": "Personal Injury",
  "section_values": {
    "statuteOfLimitations": {
      "dateValue": "2028-10-31"
    }
  }
}
```

### List collection items

List the items of a project's collection section, such as its insurance policies or medical providers.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Section (`section`, text, required): The collection section, such as Insurance or Medical Providers.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `has_more` (true/false): True if there are more than are listed
- `items` (list): The items
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "created_at": "2026-11-05T16:30:00Z",
      "fields": {
        "coverageType": "Liability",
        "policyNumber": "PN-1234"
      },
      "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
      "link": "",
      "project_id": "46774103",
      "section": "insurance",
      "section_name": "Insurance"
    }
  ],
  "total": 1
}
```

### List project activity

List a project's notes, tasks, emails and other activity, or only one kind.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Kind (`note_type`, text): Only this kind of activity. Leave blank for all. One of: `Note` (Notes), `Task` (Tasks), `Email` (Emails), `PhoneCall` (Phone calls), `Sms` (Text messages), `Fax` (Faxes), `Reminder` (Reminders), `ClientPortal` (Client portal messages).
- Added since (`created_since`, date): Only items added on or after this day.
- Added before (`created_before`, date): Only items added on or before this day.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `has_more` (true/false): True if there are more than are listed
- `notes` (list): The notes and tasks
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "notes": [
    {
      "assignee_id": "",
      "author_id": "300",
      "body": "Discussed case strategy and next steps.",
      "comment_count": 0,
      "completed_at": "",
      "completer_id": "",
      "created_at": "2026-11-05T16:10:00Z",
      "due_date": "",
      "id": "46774110",
      "is_completed": false,
      "is_task": false,
      "project_id": "46774103",
      "subject": "Client intake call",
      "type": ""
    }
  ],
  "total": 1
}
```

### List project documents

List a project's documents, by file name or upload time.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- File name (`search`, text): Words in the file name, or a #hashtag to list documents with that tag.
- Uploaded since (`uploaded_since`, date and time): Only documents uploaded at or after this time.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 1000.

**Outputs**

- `count` (number): How many are listed
- `documents` (list): The documents
- `has_more` (true/false): True if there are more than are listed
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "filename": "contract.pdf",
      "folder_id": "88123456",
      "folder_name": "Documents",
      "hashtags": [],
      "id": "46774120",
      "project_id": "46774103",
      "size": 102400,
      "uploaded_at": "2026-11-05T16:20:00Z",
      "uploader_id": "300",
      "uploader_name": "Grace Hopper"
    }
  ],
  "has_more": false,
  "total": 1
}
```

### List sections

List a project type's sections and the fields a workflow can set in each, with each field's selector.

**Inputs**

- Project type (`project_type`, text, required): The kind of project, such as Personal Injury.
- Kind (`section_type`, text): Only collections or only forms. Leave blank for both. One of: `collection` (Collections (lists of items)), `static` (Forms (one set of fields)).

**Outputs**

- `count` (number): How many sections
- `project_type_id` (text): The project type's ID
- `sections` (list): The sections

**Example output**

```json
{
  "count": 2,
  "project_type_id": "88123456",
  "sections": [
    {
      "fields": [
        {
          "choices": [],
          "name": "Policy Number",
          "selector": "policyNumber",
          "type": "String"
        },
        {
          "choices": [
            "Liability",
            "UM/UIM",
            "MedPay"
          ],
          "name": "Coverage Type",
          "selector": "coverageType",
          "type": "Dropdown"
        }
      ],
      "is_collection": true,
      "name": "Insurance",
      "selector": "insurance"
    },
    {
      "fields": [
        {
          "choices": [],
          "name": "Statute of Limitations",
          "selector": "statuteOfLimitations",
          "type": "Deadline"
        }
      ],
      "is_collection": false,
      "name": "Case Summary",
      "selector": "caseSummary"
    }
  ]
}
```

### Update collection item

Change fields of one item in a project's collection section. Fields left blank keep what they have.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Section (`section`, text, required): The collection section, such as Insurance or Medical Providers.
- Item (`item`, text, required): The item's ID, from 'List collection items', 'Create collection item' or the trigger.
- Fields (`fields`, object, required): The fields to change and their new values.

**Outputs**

- `created_at` (text): When it was added (ISO 8601)
- `fields` (object): The item's values, keyed by field selector
- `id` (text): The item's ID
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `project_id` (text): The project's ID
- `section` (text): The section's selector
- `section_name` (text): The section's name

**Example output**

```json
{
  "created_at": "2026-11-05T16:30:00Z",
  "fields": {
    "coverageType": "Liability",
    "policyNumber": "PN-1234"
  },
  "id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
  "link": "",
  "project_id": "46774103",
  "section": "insurance",
  "section_name": "Insurance"
}
```

### Update contact

Change a contact's names, birth date, job or company, or give them more person types. Fields left blank keep what they have.

**Inputs**

- Contact (`contact`, text, required): The contact's ID, from another Filevine step or the trigger.
- First name (`first_name`, text): Their first name.
- Middle name (`middle_name`, text): Their middle name.
- Last name (`last_name`, text): Their last name.
- Birth date (`birth_date`, date): Their date of birth.
- Person types (`person_types`, list): What the contact is to your firm, such as Client or Adjuster. Filevine adds these to the ones they have; it never removes one.
- Job title (`job_title`, text): Their job title, such as Claims Adjuster.
- Company (`company`, text): The company they work for.

**Outputs**

- `address` (text): Their first address, on one line
- `birth_date` (text): Their birth date (YYYY-MM-DD); empty if not set
- `city` (text): That address's city
- `company` (text): The company they work for
- `email` (text): Their primary email
- `emails` (list): All their email addresses
- `first_name` (text): Their first name
- `full_name` (text): Their full name
- `hashtags` (list): Their hashtags
- `id` (text): The contact's ID
- `is_company` (true/false): True if the contact is a company
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `middle_name` (text): Their middle name
- `modified_at` (text): When the contact last changed (ISO 8601)
- `nickname` (text): Their nickname
- `person_types` (list): Their person types, such as Client or Adjuster
- `phone` (text): Their first phone number
- `phones` (list): All their phone numbers
- `postal_code` (text): That address's postal code
- `state` (text): That address's state

**Example output**

```json
{
  "address": "12 Main St, Salt Lake City, UT 84101",
  "birth_date": "1985-12-10",
  "city": "Salt Lake City",
  "company": "Analytical Engines",
  "email": "ada@example.com",
  "emails": [
    "ada@example.com"
  ],
  "first_name": "Ada",
  "full_name": "Ada Lovelace",
  "hashtags": [],
  "id": "46774102",
  "is_company": false,
  "job_title": "Engineer",
  "last_name": "Lovelace",
  "middle_name": "",
  "modified_at": "2026-11-05T16:00:00Z",
  "nickname": "",
  "person_types": [
    "Client"
  ],
  "phone": "(801) 555-0134",
  "phones": [
    "(801) 555-0134"
  ],
  "postal_code": "84101",
  "state": "UT"
}
```

### Update project

Change a project's name, number, description or incident date. Fields left blank keep what they have.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Project name (`project_name`, text): A new name.
- Number (`number`, text): The project's number, as your firm numbers them.
- Description (`description`, text): What the project is about.
- Incident date (`incident_date`, date): When the incident happened.

**Outputs**

- `client_id` (text): The client contact's ID
- `client_name` (text): The client's name
- `contact_ids` (list): The IDs of the contacts on it
- `created_at` (text): When it was created (ISO 8601)
- `description` (text): Its description
- `first_primary_name` (text): The name of its first primary team member
- `hashtags` (list): Its hashtags
- `id` (text): The project's ID
- `incident_date` (text): The incident date (YYYY-MM-DD); empty if not set
- `is_archived` (true/false): True if it is archived
- `last_activity` (text): When anything last happened on it (ISO 8601)
- `link` (text): A link to it in Filevine; empty if Filevine gave none
- `name` (text): The project's name
- `number` (text): The project's number
- `phase_date` (text): When it entered that phase (ISO 8601)
- `phase_id` (text): The ID of the phase it is in
- `phase_name` (text): The phase it is in
- `project_email` (text): The project's own email address
- `project_type_id` (text): The ID of its project type
- `project_type_name` (text): Its project type, such as Personal Injury

**Example output**

```json
{
  "client_id": "46774102",
  "client_name": "Ada Lovelace",
  "contact_ids": [
    "46774102"
  ],
  "created_at": "2026-11-05T16:00:00Z",
  "description": "Rear-end collision on I-15.",
  "first_primary_name": "Grace Hopper",
  "hashtags": [
    "intake"
  ],
  "id": "46774103",
  "incident_date": "2026-10-31",
  "is_archived": false,
  "last_activity": "2026-11-05T16:05:00Z",
  "link": "https://example.com/#/project/46774103",
  "name": "Lovelace v. Babbage",
  "number": "PI-2026-0142",
  "phase_date": "2026-11-05T16:00:00Z",
  "phase_id": "88123457",
  "phase_name": "Intake",
  "project_email": "lovelace-v-babbage@example.com",
  "project_type_id": "88123456",
  "project_type_name": "Personal Injury"
}
```

### Update section

Fill in or change fields of a project's form section, such as its intake or case summary details. Fields left blank keep what they have.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- Section (`section`, text, required): The form section, such as Case Summary.
- Fields (`fields`, object, required): The fields to change and their new values.

**Outputs**

- `changed` (list): The selectors of the fields changed
- `project_id` (text): The project's ID
- `section` (text): The section's selector
- `section_name` (text): The section's name
- `values` (object): The section's values now, keyed by field selector

**Example output**

```json
{
  "changed": [
    "statuteOfLimitations"
  ],
  "project_id": "46774103",
  "section": "caseSummary",
  "section_name": "Case Summary",
  "values": {
    "statuteOfLimitations": {
      "dateValue": "2028-10-31"
    }
  }
}
```

### Upload document

Put a file in a project's documents, such as a signed retainer or a medical record.

**Inputs**

- Project (`project`, text, required): The project's ID, from another Filevine step or the trigger.
- File (`file`, text, required): The file: upload one, pick a file from an earlier step, or paste a public https link to one.
- File name (`file_name`, text): What to call it in Filevine, with its extension, such as retainer.pdf. Leave blank to keep the file's own name.
- Folder ID (`folder`, text): The ID of the project folder to put it in. Leave blank for the project's main documents folder.

**Outputs**

- `filename` (text): Its file name, with its extension
- `folder_id` (text): The ID of the folder it is in
- `folder_name` (text): The folder it is in
- `hashtags` (list): Its hashtags
- `id` (text): The document's ID
- `project_id` (text): The project's ID
- `size` (number): Its size in bytes
- `uploaded_at` (text): When it was uploaded (ISO 8601)
- `uploader_id` (text): The ID of the user who uploaded it
- `uploader_name` (text): Their name

**Example output**

```json
{
  "filename": "contract.pdf",
  "folder_id": "88123456",
  "folder_name": "Documents",
  "hashtags": [],
  "id": "46774120",
  "project_id": "46774103",
  "size": 102400,
  "uploaded_at": "2026-11-05T16:20:00Z",
  "uploader_id": "300",
  "uploader_name": "Grace Hopper"
}
```
