SmartAdvocate
SmartAdvocate CaseSync connector for legal case management — cases, contacts, notes, tasks, calendar appointments, documents, user-defined fields, and case workflow records.
Categories: Legal, Practice Management
What you can ask
- Open a new case for a personal-injury client and set the case type.
- List all appointments scheduled for case number 2024-0512.
- Add the plaintiff's injuries and treatment details to the case.
- Show me the outstanding tasks assigned to the litigation team.
Set up
SmartAdvocate connects with credentials from your SmartAdvocate account. Have these values ready:
- SmartAdvocate host
- Username
- Password
- Go to Organization > Connectors and find SmartAdvocate.
- Click Enable and choose which tools to allow.
- Each member enters their own values the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
SmartAdvocate offers 152 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (89)
View and search information without changing it.
| Tool | What it does |
|---|---|
download_document | Download a document's file content by document ID. |
get_case | Get one case by its internal case ID, including parties, staff, tags, and incident summary. |
get_case_incident | Get a case's incident record — the facts of what happened plus structured details like date, state, and county. |
get_case_info | Get a case by its human-readable case number, e.g. 9000002. |
get_case_status | Get one case status record by its status record ID, with dates and comments. |
get_contact | Get a contact's core details by contact ID — name, primary address, phone, and email. |
get_contact_full | Get a contact's complete record, including all addresses, emails, phones, and classification fields. |
get_document | Get one document's metadata by document ID — name, category, dates, and review state. |
get_incident_by_case_number | Get a case's incident record by its human-readable case number. |
get_injury | Get one injury record on a case, including its summaries and confinement details. |
get_injury_detail | Get one injury detail row by its ID. |
get_insurance | Get one insurance policy on a case by its insurance record ID, including carrier, adjuster, limits, and claim number. |
get_note | Get one case note by its note ID, including full body text and sharing settings. |
get_tag | Get one tag definition by ID, including its group and case-type restrictions. |
get_task | Get one task by its task ID, including assignee, dates, and attached documents. |
get_udf | Get one user-defined field's value on a case by its UDF definition ID. |
get_udf_grid_row | Get one row of a UDF grid by row ID, returning each cell's column definition ID and value. |
list_active_cases | List open cases assigned to one staff member, for workload or dashboard views. |
list_address_types | List the firm's address types for a contact category, for labelling addresses on a contact. |
list_appointment_activity_types | List the firm's appointment activity types — the secondary classification on an appointment. |
list_appointment_statuses | List the firm's appointment statuses, e.g. Scheduled or Cancelled. Call this before create_appointment. |
list_appointment_types | List the firm's appointment types, e.g. Deposition or Trial. Call this before create_appointment — type IDs are per-firm configuration. |
list_appointments_by_case_number | List every calendar appointment on one case by its human-readable case number. |
list_available_case_tags | List the tags that can still be applied to one case — those allowed for its case group and type and not already assigned. |
list_body_parts | List the body parts available on injury detail rows. |
list_case_appointments | List every calendar appointment on one case by internal case ID. |
list_case_calls | List the calls logged on one case — remote party, number, direction, date, and summary. |
list_case_contacts | List every contact linked to a case with the role each one holds — plaintiff, defendant, witness, adjuster, and so on. |
list_case_documents | List document metadata for one case, filtered server-side by category, subcategory, or originating/destination contact. |
list_case_groups | List the firm's case groups — the top-level case classification, e.g. Personal Injury. Call this before create_case or search_cases: group IDs are per-firm configuration. Feed a group ID to list_case_types. |
list_case_injuries | List the injury records on a case, one per injured plaintiff. |
list_case_insurance | List the insurance policies on a case for one side. party is required: 'P' for plaintiff-side coverage, 'D' for defendant-side — they are separate lists, so check both to see all policies. |
list_case_notes | List the notes on one case by internal case ID, newest first. |
list_case_staff | List the staff assigned to one case with their roles. |
list_case_statuses | List a case's status history by internal case ID — each record with its type, value, and effective dates. |
list_case_subtypes | List the subtypes inside one case type — the third-level classification. |
list_case_tasks | List the tasks on one case by internal case ID. |
list_case_types | List the case types inside one case group — the second-level classification. |
list_case_udfs | List a case's user-defined fields and their current values — SmartAdvocate's custom fields. |
list_contact_addresses | List a contact's postal addresses. |
list_contact_emails | List a contact's email addresses. |
list_contact_phones | List a contact's phone numbers with their labels and texting flags. |
list_contact_subcategories | List the firm's contact subcategories. |
list_contact_types | List the firm's contact types for a contact category. |
list_defendants | List the defendants on a case with their roles and contact IDs. |
list_document_categories | List the firm's document categories with their subcategories, one row per category/subcategory pair. |
list_document_folders | List the document folders configured on one case. |
list_document_tags | List the firm's document tags. |
list_documents_by_case_number | List document metadata for one case by its human-readable case number, with the same category and contact filters. |
list_incident_counties | List the counties available on incident records. |
list_incident_states | List the states available on incident records. |
list_injury_details | List the detail rows under one injury — each a body part with its treatments and sequelae. |
list_injury_names | List the firm's catalogue of injury names. |
list_insurance_by_case_number | List insurance policies for one side of a case by its human-readable case number. |
list_insurance_types | List the firm's insurance types, e.g. auto liability or health. |
list_liability_codes | List the firm's liability codes for incident records. |
list_note_types | List the firm's note types. |
list_notes_by_case_number | List the notes on one case by its human-readable case number. |
list_phone_types | List the firm's phone types, e.g. Mobile Phone or Work Phone. Use one of these as the name when calling add_contact_phones. |
list_plaintiff_roles | List the plaintiff roles available for a case type, e.g. Passenger or Driver. Call this before add_plaintiff — role IDs are per-firm configuration. Pass 0 for roles across all case types. |
list_plaintiffs | List the plaintiffs on a case with their roles and contact IDs. |
list_related_cases | List cases linked to this one as related matters — consolidated cases, companion cases, or other cases involving the same parties. |
list_related_contacts | List contacts related to a given contact, with the relationship each one holds — family members, employers, and similar links. |
list_sequelae | List the sequelae — follow-on conditions — recorded for one body part. |
list_staff_by_case_number | List staff assignments by case number. |
list_status_types | List the firm's case status types and the status values inside each one. |
list_statuses_by_case_number | List a case's status history by its human-readable case number. |
list_tags | List every tag defined in the firm, with its active state and any case-group or case-type restrictions. |
list_task_priorities | List the firm's task priority levels, e.g. Normal or High. Call this before create_task or update_task. |
list_task_statuses | List the firm's task statuses, e.g. Not Started or Completed. Call this before create_task, update_task, or search_tasks. |
list_task_types | List the firm's task types. |
list_tasks_by_case_number | List the tasks on one case by its human-readable case number. |
list_treatments | List the treatments available for one body part. |
list_udf_grid_rows | List the rows of a UDF grid on a case. |
list_udfs_by_case_number | List a case's user-defined fields by its human-readable case number. |
lookup_cases | Look up cases by a single criterion, e.g. every case with a given status. |
lookup_contacts | Find contacts by name or phone number — the way to resolve a person to a contact ID before add_case_contact, add_plaintiff, or create_call. |
search_appointments | Search appointments across cases for firm-wide calendars and deadline reports. |
search_case_staff | Search staff assignments across cases by modified-date window, optionally restricted to specific case numbers. |
search_case_statuses | Search case status records across cases by modified-date window, optionally restricted to specific case numbers. |
search_cases | Search cases modified within a date range, optionally narrowed by case number, case type, case group, or tag. |
search_contacts | Search contacts by modified-date window, optionally restricted to those linked to given case numbers. |
search_documents | Search document metadata across cases by modified-date window, narrowed by case number, category, subcategory, or contact. |
search_incidents | Search incident records across cases by modified-date window, optionally restricted to specific case numbers. |
search_injuries | Search injury records across cases by modified-date window, optionally restricted to specific case numbers. |
search_notes | Search notes across cases by modified-date window, optionally restricted to specific case numbers. |
search_tasks | Search tasks across cases, filtering by modified window, due-date range, type, status, assignee, or template. |
search_udfs | Search user-defined field values across cases by modified-date window, optionally restricted to specific case numbers. |
validate_credential | Check that the SmartAdvocate connection works by signing in and reading the firm's case groups. |
Delete or overwrite (63)
Remove or replace existing data.
| Tool | What it does |
|---|---|
add_case_contact | Link an existing contact to a case in a role. |
add_case_tags | Apply one or more existing tags to a case. |
add_contact_addresses | Add one or more postal addresses to a contact. |
add_contact_emails | Add one or more email addresses to a contact. |
add_contact_phones | Add one or more phone numbers to a contact. |
add_injury_details_by_cpt | Add procedure detail rows to an injury from CPT procedure codes, letting SmartAdvocate map each code to the right treatment. |
add_injury_details_by_icd | Add injury detail rows from ICD diagnosis codes, letting SmartAdvocate map each code to the right body part and injury. |
add_plaintiff | Add a plaintiff to a case. |
bulk_update_udfs | Set several user-defined field values on one case in a single transaction — if any entry is invalid nothing is written. |
create_appointment | Schedule an appointment on a case — a hearing, deposition, meeting, or reminder. |
create_call | Log a phone call on a case. direction is true for outbound and false for inbound. |
create_case | Open a new case from intake details. |
create_case_status | Add a status record to a case. |
create_contact | Create a contact. |
create_document | Create a document metadata record on a case. |
create_injury | Create an injury record for one plaintiff on a case. plaintiff_id is the plaintiff RECORD id from list_plaintiffs, not the contact ID. |
create_injury_detail | Add a body-part detail row to an injury. |
create_insurance | Record an insurance policy on a case. |
create_note | Add a note to a case. |
create_tag | Define a new tag that can be applied to cases. |
create_task | Create a task on a case. |
create_udf_grid_row | Add a row to a UDF grid on a case. |
delete_call | Delete a logged call from a case permanently. |
delete_case_contact | Unlink a contact from a case. |
delete_contact_address | Delete one address from a contact permanently. |
delete_contact_email | Delete one email address from a contact permanently. |
delete_contact_phone | Delete one phone number from a contact permanently. |
delete_injury | Delete an injury record from a case permanently, along with its detail rows. |
delete_injury_detail | Delete one injury detail row permanently. |
delete_insurance | Delete an insurance policy from a case permanently. |
delete_tag | Delete a tag definition permanently. |
delete_task | Delete a task permanently by its task ID. |
delete_udf_grid_row | Delete a row from a UDF grid on a case. |
patch_call | Change selected fields on a logged call, leaving the others untouched. |
patch_case_contact | Change selected fields on a case-contact link, leaving the others untouched. |
patch_contact | Change selected fields on a contact, leaving the others untouched. |
patch_contact_address | Change selected fields on one of a contact's addresses. |
patch_contact_email | Change selected fields on one of a contact's email addresses. |
patch_contact_phone | Change selected fields on one of a contact's phone numbers. |
patch_document | Change selected metadata fields on a document, leaving the others untouched. |
patch_incident | Change selected fields on a case's incident record, leaving the others untouched. |
patch_injury_detail | Change selected fields on an injury detail row, leaving the others untouched. |
patch_insurance | Change selected fields on an insurance policy, leaving the others untouched. |
patch_note | Change selected fields on a note, leaving the others untouched. |
patch_plaintiff | Change selected fields on a plaintiff record, leaving the others untouched. |
patch_task | Change selected fields on a task, leaving the others untouched. |
remove_case_tags | Take one or more tags off a case. |
terminate_case_status | Close out the active status of a given type on a case by stamping its end date. |
update_call | Replace a logged call in full. |
update_case_contact | Replace a case-contact link's role and comments. |
update_case_number | Change a case's human-readable case number. |
update_document | Replace a document's metadata in full. |
update_incident | Replace a case's incident facts and structured details. |
update_injury | Replace an injury record's summaries, confinement details, and comments. |
update_injury_detail | Replace an injury detail row. |
update_insurance | Replace an insurance policy in full. |
update_note | Replace a note in full — type, body, date, subject, contact, priority and sharing. |
update_status_comment | Change the comment on an existing case status record. |
update_tag | Update a tag definition's name, active state, or group restrictions. |
update_task | Replace a task in full. |
update_udf | Set one user-defined field's value on a case. |
update_udf_grid_row | Replace a UDF grid row's cells. |
upload_document_content | Attach file content to an existing document record. |