Smokeball

App · 20 actions

Run your law firm's Smokeball from workflows: open and update matters, add contacts, tasks, memos, time entries, expenses and calendar events. Start a workflow when a matter is opened or changed, a contact is added or changed, or a task is added or completed.

Actions

ActionWhat it does
Add calendar eventAdd an appointment to Smokeball's calendar, such as a meeting or a hearing, on a matter or on its own.
Add contactAdd a person or a company to your firm's contacts.
Add expenseRecord a cost on a matter, such as a filing fee or travel.
Add memoAdd a memo (file note) to a matter, such as a note of a call.
Add taskAdd a task, on a matter or on its own, and assign it to staff.
Add time entryRecord time worked on a matter, billed at the staff member's rate unless you give one.
Create matterOpen a new matter for one or more client contacts.
Delete contactDelete a contact.
Delete taskDelete a task.
Get contactGet one contact with every detail Smokeball holds.
Get matterGet one matter with its type, clients, other sides, staff, status and dates.
Get taskGet one task with its matter, assignees, notes and dates.
List contactsFind people and companies in your firm's contacts by name or email.
List mattersList your firm's matters, with their number, title, status, type, clients and the staff responsible.
List memosList the memos (file notes) on a matter, with their text.
List tasksList tasks, on one matter or across the firm, with who they are assigned to and when they are due.
List time and feesList the time entries and fixed fees on a matter, with who did the work, minutes and amounts.
Update contactChange a person's or company's name, email, phone or notes.
Update matterChange a matter's description, status, staff, number or dates.
Update taskChange a task's subject, notes, due date or assignees, or mark it completed.

Add calendar event

Add an appointment to Smokeball's calendar, such as a meeting or a hearing, on a matter or on its own. Smokeball saves it within a few seconds.

Inputs

SubjectsubjecttextRequired
What the event is.
Startsstart_timedate and timeRequired
When it starts.
Endsend_timedate and timeRequired
When it ends.
Time zonetime_zonetext
The time zone to show it in. Defaults to UTC.
Mattermatter_idtext
The matter it belongs to, if any.
Attendeesattendee_idslist
The staff members attending.
Locationlocationtext
Where it is.
Descriptiondescriptiontext
More detail.
All dayall_daytrue/false
On makes it an all-day event.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/events/5d0e7a4c-2b9f-4c61-8e3a-7f1b6d2c9e05",
  "id": "5d0e7a4c-2b9f-4c61-8e3a-7f1b6d2c9e05"
}

Add contact

Add a person or a company to your firm's contacts. Smokeball saves it within a few seconds.

Inputs

Typecontact_typetext
A person or a company. Defaults to a person.One of: person, company. Default: person.
First namefirst_nametext
A person's first name.
Last namelast_nametext
A person's last name.
Company namecompany_nametext
A company's name.
Emailemailtext
Their email address.
Phonephonetext
Their phone number.
Mobilemobiletext
A person's mobile number.
Notesnotestext
Notes on the contact.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/contacts/9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
  "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f"
}

Add expense

Record a cost on a matter, such as a filing fee or travel. Smokeball saves it within a few seconds.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
SubjectsubjecttextRequired
What it was for.
PricepricenumberRequired
The cost of one unit, such as 45.50.
Quantityquantitynumber
How many units. Defaults to 1.Default: 1.
Dateexpense_datedate
When it was spent. Defaults to today.
Cost typecost_typetext
Defaults to a hard cost.One of: Hard (Hard cost, such as travel or filing fees (default)), Soft (Soft cost, such as copying or admin). Default: Hard.
Staff memberstaff_idtext
Who spent it. Leave blank to file it under the firm's owner.
Descriptiondescriptiontext
More detail.
Billablebillabletrue/false
Off records it without billing it. Defaults to on.Default: true.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/expenses/0b6d2c1e-8f4a-4e3b-a1d9-2c7f5e9b3a60",
  "id": "0b6d2c1e-8f4a-4e3b-a1d9-2c7f5e9b3a60"
}

Add memo

Add a memo (file note) to a matter, such as a note of a call. Smokeball saves it within a few seconds.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
TitletitletextRequired
A short title.
TexttexttextRequired
What the memo says.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/matters/3f2c7a10-55a1-4f0e-9a43-0c7d8b9e6f21",
  "id": "3f2c7a10-55a1-4f0e-9a43-0c7d8b9e6f21"
}

Add task

Add a task, on a matter or on its own, and assign it to staff. Smokeball saves it within a few seconds.

Inputs

SubjectsubjecttextRequired
What needs doing.
Created bystaff_idtextRequired
The staff member adding the task. It is assigned to them unless you pick others.
Assign toassignee_idslist
The staff members to do it.
Mattermatter_idtext
The matter it belongs to, if any.
Due ondue_datedate
When it is due.
Notesnotetext
More detail.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/tasks/1bf55840-cba3-4f8a-8c0f-66082692e493",
  "id": "1bf55840-cba3-4f8a-8c0f-66082692e493"
}

Add time entry

Record time worked on a matter, billed at the staff member's rate unless you give one. Smokeball saves it within a few seconds.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
Staff memberstaff_idtextRequired
Who did the work.
SubjectsubjecttextRequired
What the work was.
MinutesminutesnumberRequired
How long, in minutes, such as 30.
Datefee_datedate
When the work was done. Defaults to today.
Hourly rateratenumber
Leave blank to use the staff member's rate in Smokeball.
Descriptiondescriptiontext
More detail.
Billablebillabletrue/false
Off records the time without billing it. Defaults to on.Default: true.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/fees/7e3f6b52-1a0c-4b8e-9f27-5d61c2a8e914",
  "id": "7e3f6b52-1a0c-4b8e-9f27-5d61c2a8e914"
}

Create matter

Open a new matter for one or more client contacts. Smokeball saves it within a few seconds.

Inputs

Matter typematter_type_idtextRequired
The area of law and state, such as Financing (Real Estate, IL).
Clientsclient_idslistRequired
The client contacts. Pick them, or give IDs from an earlier step such as 'Add contact'.
Descriptiondescriptiontext
What the matter is about.
Statusstatustext
Defaults to Open.One of: Open, Pending, Closed, Cancelled, Deleted. Default: Open.
Person responsibleperson_responsible_idtext
The staff member responsible for the matter.
Person assistingperson_assisting_idtext
The staff member assisting.
Other sideother_side_idslist
Contacts on the other side, if any.
Matter numbernumbertext
Leave blank for Smokeball to number it.
Opened onopened_datedate
Defaults to today. Can be earlier.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/matters/51cefb72-6247-4ca2-8926-5d14d65f7cb9",
  "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9"
}

Delete contact

Delete a contact. Smokeball keeps deleted contacts, and they can be restored there.

Inputs

Contactcontact_idtextRequired
The contact. Pick one, or give its ID from an earlier step.

Outputs

deletedtrue/false
Always true once done
idtext
The record deleted
Example output
{
  "deleted": true,
  "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f"
}

Delete task

Delete a task.

Inputs

Tasktask_idtextRequired
The task's ID, from 'List tasks', 'Add task' or a task trigger.

Outputs

deletedtrue/false
Always true once done
idtext
The record deleted
Example output
{
  "deleted": true,
  "id": "1bf55840-cba3-4f8a-8c0f-66082692e493"
}

Get contact

Get one contact with every detail Smokeball holds.

Inputs

Contactcontact_idtextRequired
The contact. Pick one, or give its ID from an earlier step.

Outputs

contactobject
The contact
nametext
Their name, ready to use
Example output
{
  "contact": {
    "company": null,
    "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
    "isDeleted": false,
    "lastUpdated": 638668800000000000,
    "person": {
      "cell": {
        "areaCode": "",
        "number": ""
      },
      "email": "jane.smith@example.com",
      "firstName": "Jane",
      "lastName": "Smith",
      "notes": "",
      "phone": {
        "areaCode": "312",
        "number": "555 0100"
      }
    }
  },
  "name": "Jane Smith"
}

Get matter

Get one matter with its type, clients, other sides, staff, status and dates.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.

Outputs

matterobject
The matter
Example output
{
  "matter": {
    "clients": [
      {
        "href": "https://api.smokeball.com/contacts/9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
        "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f"
      }
    ],
    "closedDate": null,
    "description": "Sale of 12 Oak Street",
    "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9",
    "matterType": {
      "href": "https://api.smokeball.com/mattertypes/8aca3574-aecb-4a6f-991d-680861bece1d_IL",
      "id": "8aca3574-aecb-4a6f-991d-680861bece1d_IL"
    },
    "number": "Matter-001",
    "openedDate": "2026-11-03T04:18:22Z",
    "otherSides": [],
    "personAssisting": null,
    "personResponsible": {
      "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
      "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
    },
    "status": "Open",
    "title": "Matter-001 - Smith - Sale - Jones",
    "versionId": "638138489289266248"
  }
}

Get task

Get one task with its matter, assignees, notes and dates.

Inputs

Tasktask_idtextRequired
The task's ID, from 'List tasks', 'Add task' or a task trigger.

Outputs

taskobject
The task
Example output
{
  "task": {
    "assignees": [
      {
        "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
        "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
      }
    ],
    "completedBy": null,
    "completedDateOnly": null,
    "createdBy": {
      "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
      "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
    },
    "createdDateOnly": "2026-11-18T00:00:00",
    "dueDateOnly": "2026-11-20T00:00:00",
    "id": "1bf55840-cba3-4f8a-8c0f-66082692e493",
    "isCompleted": false,
    "lastUpdated": 638675712000000000,
    "matter": {
      "href": "https://api.smokeball.com/matters/51cefb72-6247-4ca2-8926-5d14d65f7cb9",
      "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9"
    },
    "note": "Use the residential template.",
    "subject": "Send engagement letter"
  }
}

List contacts

Find people and companies in your firm's contacts by name or email.

Inputs

Namenametext
Part of the contact's name.
Emailemailtext
The contact's exact email address.
Typecontact_typetext
Only people, or only companies. Leave blank for both.One of: person, company.
How manylimitnumber
The most to return, up to 2,000. Defaults to 100.Default: 100.

Outputs

contactslist
The contacts
countnumber
How many were returned
totalnumber
How many Smokeball holds in all
Example output
{
  "contacts": [
    {
      "company": null,
      "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
      "isDeleted": false,
      "lastUpdated": 638668800000000000,
      "person": {
        "cell": {
          "areaCode": "",
          "number": ""
        },
        "email": "jane.smith@example.com",
        "firstName": "Jane",
        "lastName": "Smith",
        "notes": "",
        "phone": {
          "areaCode": "312",
          "number": "555 0100"
        }
      }
    }
  ],
  "count": 1,
  "total": 1
}

List matters

List your firm's matters, with their number, title, status, type, clients and the staff responsible.

Inputs

Searchsearchtext
Words to look for in clients, other sides, descriptions and matter numbers.
Statusstatuslist
Only matters with these statuses. Leave blank for any.One or more of: Open, Pending, Closed, Cancelled, Deleted.
Matter typematter_type_idtext
Only matters of this type.
Contactcontact_idtext
Only matters this contact is on.
How manylimitnumber
The most to return, up to 2,000. Defaults to 100.Default: 100.

Outputs

countnumber
How many were returned
matterslist
The matters
totalnumber
How many Smokeball holds in all
Example output
{
  "count": 1,
  "matters": [
    {
      "clients": [
        {
          "href": "https://api.smokeball.com/contacts/9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
          "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f"
        }
      ],
      "closedDate": null,
      "description": "Sale of 12 Oak Street",
      "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9",
      "matterType": {
        "href": "https://api.smokeball.com/mattertypes/8aca3574-aecb-4a6f-991d-680861bece1d_IL",
        "id": "8aca3574-aecb-4a6f-991d-680861bece1d_IL"
      },
      "number": "Matter-001",
      "openedDate": "2026-11-03T04:18:22Z",
      "otherSides": [],
      "personAssisting": null,
      "personResponsible": {
        "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
        "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
      },
      "status": "Open",
      "title": "Matter-001 - Smith - Sale - Jones",
      "versionId": "638138489289266248"
    }
  ],
  "total": 1
}

List memos

List the memos (file notes) on a matter, with their text.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
How manylimitnumber
The most to return, up to 2,000. Defaults to 100.Default: 100.

Outputs

countnumber
How many were returned
memoslist
The memos
totalnumber
How many Smokeball holds in all
Example output
{
  "count": 1,
  "memos": [
    {
      "createdByUserId": "526670af-acd8-401e-bc64-6d4cafb4a12a",
      "createdDate": "2026-11-18T03:12:00Z",
      "id": "3f2c7a10-55a1-4f0e-9a43-0c7d8b9e6f21",
      "lastUpdated": "2026-11-18T03:12:00Z",
      "matterId": "51cefb72-6247-4ca2-8926-5d14d65f7cb9",
      "plainText": "Client confirmed the settlement date.",
      "title": "Call with client"
    }
  ],
  "total": 1
}

List tasks

List tasks, on one matter or across the firm, with who they are assigned to and when they are due.

Inputs

Mattermatter_idtext
Only tasks on this matter. Leave blank for every matter.
Statusstatustext
Tasks not yet completed, completed ones, or both.One of: open (Not completed (default)), completed, all (Both). Default: open.
How manylimitnumber
The most to return, up to 2,000. Defaults to 100.Default: 100.

Outputs

countnumber
How many were returned
taskslist
The tasks
totalnumber
How many Smokeball holds in all
Example output
{
  "count": 1,
  "tasks": [
    {
      "assignees": [
        {
          "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
          "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
        }
      ],
      "completedBy": null,
      "completedDateOnly": null,
      "createdBy": {
        "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
        "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
      },
      "createdDateOnly": "2026-11-18T00:00:00",
      "dueDateOnly": "2026-11-20T00:00:00",
      "id": "1bf55840-cba3-4f8a-8c0f-66082692e493",
      "isCompleted": false,
      "lastUpdated": 638675712000000000,
      "matter": {
        "href": "https://api.smokeball.com/matters/51cefb72-6247-4ca2-8926-5d14d65f7cb9",
        "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9"
      },
      "note": "Use the residential template.",
      "subject": "Send engagement letter"
    }
  ],
  "total": 1
}

List time and fees

List the time entries and fixed fees on a matter, with who did the work, minutes and amounts.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
How manylimitnumber
The most to return, up to 2,000. Defaults to 100.Default: 100.

Outputs

countnumber
How many were returned
feeslist
The time entries and fees
totalnumber
How many Smokeball holds in all
Example output
{
  "count": 1,
  "fees": [
    {
      "amount": 175,
      "createdDate": "2026-11-18T03:20:00Z",
      "description": "",
      "duration": 30,
      "feeDate": "2026-11-18T00:00:00Z",
      "feeType": 1,
      "id": "7e3f6b52-1a0c-4b8e-9f27-5d61c2a8e914",
      "isBillable": true,
      "matter": {
        "href": "https://api.smokeball.com/matters/51cefb72-6247-4ca2-8926-5d14d65f7cb9",
        "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9"
      },
      "rate": 350,
      "staff": {
        "href": "https://api.smokeball.com/staff/c85d28cb-a760-4627-aa59-0a853c2e65ed",
        "id": "c85d28cb-a760-4627-aa59-0a853c2e65ed"
      },
      "subject": "Review contract of sale"
    }
  ],
  "total": 1
}

Update contact

Change a person's or company's name, email, phone or notes. Fields left blank stay as they are. Smokeball saves it within a few seconds.

Inputs

Contactcontact_idtextRequired
The contact. Pick one, or give its ID from an earlier step.
First namefirst_nametext
A person's first name. Leave blank to keep it.
Last namelast_nametext
A person's last name. Leave blank to keep it.
Company namecompany_nametext
A company's name. Leave blank to keep it.
Emailemailtext
Their email address. Leave blank to keep it.
Phonephonetext
Their phone number. Leave blank to keep it.
Mobilemobiletext
A person's mobile number. Leave blank to keep it.
Notesnotestext
Notes on the contact. Leave blank to keep it. Replaces the notes there.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/contacts/9a9ce552-6bee-45e4-8eb1-afe2c18c489f",
  "id": "9a9ce552-6bee-45e4-8eb1-afe2c18c489f"
}

Update matter

Change a matter's description, status, staff, number or dates. Fields left blank stay as they are. Smokeball saves it within a few seconds.

Inputs

Mattermatter_idtextRequired
The matter. Pick an open one, or give its ID from an earlier step.
Descriptiondescriptiontext
A new description.
Statusstatustext
The matter's status.One of: Open, Pending, Closed, Cancelled, Deleted.
Person responsibleperson_responsible_idtext
The staff member now responsible.
Person assistingperson_assisting_idtext
The staff member now assisting.
Matter numbernumbertext
A new matter number.
Opened onopened_datedate
A new opened date.
Closed onclosed_datedate
When the matter was closed.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/matters/51cefb72-6247-4ca2-8926-5d14d65f7cb9",
  "id": "51cefb72-6247-4ca2-8926-5d14d65f7cb9"
}

Update task

Change a task's subject, notes, due date or assignees, or mark it completed. Fields left blank stay as they are. Smokeball saves it within a few seconds.

Inputs

Tasktask_idtextRequired
The task's ID, from 'List tasks', 'Add task' or a task trigger.
Subjectsubjecttext
A new subject.
Notesnotetext
New notes. Replaces the notes there.
Due ondue_datedate
A new due date.
Assign toassignee_idslist
The staff members to do it. Replaces those assigned now.
Completedcompletedtrue/false
On marks the task completed; off reopens it.
Changed bystaff_idtext
The staff member making the change. Defaults to whoever last changed the task.

Outputs

hreftext
Its address in Smokeball's API
idtext
The record's ID, for the next step
Example output
{
  "href": "https://api.smokeball.com/tasks/1bf55840-cba3-4f8a-8c0f-66082692e493",
  "id": "1bf55840-cba3-4f8a-8c0f-66082692e493"
}

On this page