Skip to main content

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
  1. Go to Organization > Connectors and find SmartAdvocate.
  2. Click Enable and choose which tools to allow.
  3. 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.

ToolWhat it does
download_documentDownload a document's file content by document ID.
get_caseGet one case by its internal case ID, including parties, staff, tags, and incident summary.
get_case_incidentGet a case's incident record — the facts of what happened plus structured details like date, state, and county.
get_case_infoGet a case by its human-readable case number, e.g. 9000002.
get_case_statusGet one case status record by its status record ID, with dates and comments.
get_contactGet a contact's core details by contact ID — name, primary address, phone, and email.
get_contact_fullGet a contact's complete record, including all addresses, emails, phones, and classification fields.
get_documentGet one document's metadata by document ID — name, category, dates, and review state.
get_incident_by_case_numberGet a case's incident record by its human-readable case number.
get_injuryGet one injury record on a case, including its summaries and confinement details.
get_injury_detailGet one injury detail row by its ID.
get_insuranceGet one insurance policy on a case by its insurance record ID, including carrier, adjuster, limits, and claim number.
get_noteGet one case note by its note ID, including full body text and sharing settings.
get_tagGet one tag definition by ID, including its group and case-type restrictions.
get_taskGet one task by its task ID, including assignee, dates, and attached documents.
get_udfGet one user-defined field's value on a case by its UDF definition ID.
get_udf_grid_rowGet one row of a UDF grid by row ID, returning each cell's column definition ID and value.
list_active_casesList open cases assigned to one staff member, for workload or dashboard views.
list_address_typesList the firm's address types for a contact category, for labelling addresses on a contact.
list_appointment_activity_typesList the firm's appointment activity types — the secondary classification on an appointment.
list_appointment_statusesList the firm's appointment statuses, e.g. Scheduled or Cancelled. Call this before create_appointment.
list_appointment_typesList 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_numberList every calendar appointment on one case by its human-readable case number.
list_available_case_tagsList the tags that can still be applied to one case — those allowed for its case group and type and not already assigned.
list_body_partsList the body parts available on injury detail rows.
list_case_appointmentsList every calendar appointment on one case by internal case ID.
list_case_callsList the calls logged on one case — remote party, number, direction, date, and summary.
list_case_contactsList every contact linked to a case with the role each one holds — plaintiff, defendant, witness, adjuster, and so on.
list_case_documentsList document metadata for one case, filtered server-side by category, subcategory, or originating/destination contact.
list_case_groupsList 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_injuriesList the injury records on a case, one per injured plaintiff.
list_case_insuranceList 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_notesList the notes on one case by internal case ID, newest first.
list_case_staffList the staff assigned to one case with their roles.
list_case_statusesList a case's status history by internal case ID — each record with its type, value, and effective dates.
list_case_subtypesList the subtypes inside one case type — the third-level classification.
list_case_tasksList the tasks on one case by internal case ID.
list_case_typesList the case types inside one case group — the second-level classification.
list_case_udfsList a case's user-defined fields and their current values — SmartAdvocate's custom fields.
list_contact_addressesList a contact's postal addresses.
list_contact_emailsList a contact's email addresses.
list_contact_phonesList a contact's phone numbers with their labels and texting flags.
list_contact_subcategoriesList the firm's contact subcategories.
list_contact_typesList the firm's contact types for a contact category.
list_defendantsList the defendants on a case with their roles and contact IDs.
list_document_categoriesList the firm's document categories with their subcategories, one row per category/subcategory pair.
list_document_foldersList the document folders configured on one case.
list_document_tagsList the firm's document tags.
list_documents_by_case_numberList document metadata for one case by its human-readable case number, with the same category and contact filters.
list_incident_countiesList the counties available on incident records.
list_incident_statesList the states available on incident records.
list_injury_detailsList the detail rows under one injury — each a body part with its treatments and sequelae.
list_injury_namesList the firm's catalogue of injury names.
list_insurance_by_case_numberList insurance policies for one side of a case by its human-readable case number.
list_insurance_typesList the firm's insurance types, e.g. auto liability or health.
list_liability_codesList the firm's liability codes for incident records.
list_note_typesList the firm's note types.
list_notes_by_case_numberList the notes on one case by its human-readable case number.
list_phone_typesList 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_rolesList 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_plaintiffsList the plaintiffs on a case with their roles and contact IDs.
list_related_casesList cases linked to this one as related matters — consolidated cases, companion cases, or other cases involving the same parties.
list_related_contactsList contacts related to a given contact, with the relationship each one holds — family members, employers, and similar links.
list_sequelaeList the sequelae — follow-on conditions — recorded for one body part.
list_staff_by_case_numberList staff assignments by case number.
list_status_typesList the firm's case status types and the status values inside each one.
list_statuses_by_case_numberList a case's status history by its human-readable case number.
list_tagsList every tag defined in the firm, with its active state and any case-group or case-type restrictions.
list_task_prioritiesList the firm's task priority levels, e.g. Normal or High. Call this before create_task or update_task.
list_task_statusesList the firm's task statuses, e.g. Not Started or Completed. Call this before create_task, update_task, or search_tasks.
list_task_typesList the firm's task types.
list_tasks_by_case_numberList the tasks on one case by its human-readable case number.
list_treatmentsList the treatments available for one body part.
list_udf_grid_rowsList the rows of a UDF grid on a case.
list_udfs_by_case_numberList a case's user-defined fields by its human-readable case number.
lookup_casesLook up cases by a single criterion, e.g. every case with a given status.
lookup_contactsFind 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_appointmentsSearch appointments across cases for firm-wide calendars and deadline reports.
search_case_staffSearch staff assignments across cases by modified-date window, optionally restricted to specific case numbers.
search_case_statusesSearch case status records across cases by modified-date window, optionally restricted to specific case numbers.
search_casesSearch cases modified within a date range, optionally narrowed by case number, case type, case group, or tag.
search_contactsSearch contacts by modified-date window, optionally restricted to those linked to given case numbers.
search_documentsSearch document metadata across cases by modified-date window, narrowed by case number, category, subcategory, or contact.
search_incidentsSearch incident records across cases by modified-date window, optionally restricted to specific case numbers.
search_injuriesSearch injury records across cases by modified-date window, optionally restricted to specific case numbers.
search_notesSearch notes across cases by modified-date window, optionally restricted to specific case numbers.
search_tasksSearch tasks across cases, filtering by modified window, due-date range, type, status, assignee, or template.
search_udfsSearch user-defined field values across cases by modified-date window, optionally restricted to specific case numbers.
validate_credentialCheck that the SmartAdvocate connection works by signing in and reading the firm's case groups.

Delete or overwrite (63)​

Remove or replace existing data.

ToolWhat it does
add_case_contactLink an existing contact to a case in a role.
add_case_tagsApply one or more existing tags to a case.
add_contact_addressesAdd one or more postal addresses to a contact.
add_contact_emailsAdd one or more email addresses to a contact.
add_contact_phonesAdd one or more phone numbers to a contact.
add_injury_details_by_cptAdd procedure detail rows to an injury from CPT procedure codes, letting SmartAdvocate map each code to the right treatment.
add_injury_details_by_icdAdd injury detail rows from ICD diagnosis codes, letting SmartAdvocate map each code to the right body part and injury.
add_plaintiffAdd a plaintiff to a case.
bulk_update_udfsSet several user-defined field values on one case in a single transaction — if any entry is invalid nothing is written.
create_appointmentSchedule an appointment on a case — a hearing, deposition, meeting, or reminder.
create_callLog a phone call on a case. direction is true for outbound and false for inbound.
create_caseOpen a new case from intake details.
create_case_statusAdd a status record to a case.
create_contactCreate a contact.
create_documentCreate a document metadata record on a case.
create_injuryCreate 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_detailAdd a body-part detail row to an injury.
create_insuranceRecord an insurance policy on a case.
create_noteAdd a note to a case.
create_tagDefine a new tag that can be applied to cases.
create_taskCreate a task on a case.
create_udf_grid_rowAdd a row to a UDF grid on a case.
delete_callDelete a logged call from a case permanently.
delete_case_contactUnlink a contact from a case.
delete_contact_addressDelete one address from a contact permanently.
delete_contact_emailDelete one email address from a contact permanently.
delete_contact_phoneDelete one phone number from a contact permanently.
delete_injuryDelete an injury record from a case permanently, along with its detail rows.
delete_injury_detailDelete one injury detail row permanently.
delete_insuranceDelete an insurance policy from a case permanently.
delete_tagDelete a tag definition permanently.
delete_taskDelete a task permanently by its task ID.
delete_udf_grid_rowDelete a row from a UDF grid on a case.
patch_callChange selected fields on a logged call, leaving the others untouched.
patch_case_contactChange selected fields on a case-contact link, leaving the others untouched.
patch_contactChange selected fields on a contact, leaving the others untouched.
patch_contact_addressChange selected fields on one of a contact's addresses.
patch_contact_emailChange selected fields on one of a contact's email addresses.
patch_contact_phoneChange selected fields on one of a contact's phone numbers.
patch_documentChange selected metadata fields on a document, leaving the others untouched.
patch_incidentChange selected fields on a case's incident record, leaving the others untouched.
patch_injury_detailChange selected fields on an injury detail row, leaving the others untouched.
patch_insuranceChange selected fields on an insurance policy, leaving the others untouched.
patch_noteChange selected fields on a note, leaving the others untouched.
patch_plaintiffChange selected fields on a plaintiff record, leaving the others untouched.
patch_taskChange selected fields on a task, leaving the others untouched.
remove_case_tagsTake one or more tags off a case.
terminate_case_statusClose out the active status of a given type on a case by stamping its end date.
update_callReplace a logged call in full.
update_case_contactReplace a case-contact link's role and comments.
update_case_numberChange a case's human-readable case number.
update_documentReplace a document's metadata in full.
update_incidentReplace a case's incident facts and structured details.
update_injuryReplace an injury record's summaries, confinement details, and comments.
update_injury_detailReplace an injury detail row.
update_insuranceReplace an insurance policy in full.
update_noteReplace a note in full — type, body, date, subject, contact, priority and sharing.
update_status_commentChange the comment on an existing case status record.
update_tagUpdate a tag definition's name, active state, or group restrictions.
update_taskReplace a task in full.
update_udfSet one user-defined field's value on a case.
update_udf_grid_rowReplace a UDF grid row's cells.
upload_document_contentAttach file content to an existing document record.
⌘J