SIGNALS Docs
Reader View

Activities

Track tasks, calls, meetings, emails, and follow-ups against accounts and rentals. Activity types are user-configurable.

Overview

Activities represent CRM engagement items in Signals. Each activity has a type, status, priority, and can be linked to an account or rental via the "regarding" association. Activities help teams track follow-ups, schedule calls, log meetings, and manage tasks.

Activity Type is user-configurable via Settings → Lists (the Activity Type list). Admins can add, rename, reorder, or deactivate types. The seeded defaults are:

Type Description
Task General to-do items and action points
Call Phone calls — scheduled or logged
Fax Fax correspondence records
Email Email correspondence records
Meeting In-person or virtual meetings
Note Free-form notes and observations
Letter Physical letter correspondence records

Activities Workspace

Route: /activities (requires activities.view)

The activities workspace answers what needs a human today, whose it is, and what can be cleared right now. Everyone chooses one of two views; both show the same activities with the same scope, filters, bulk actions, Undo and permissions.

My day (default)

My day: greeting, next up, today's ribbon and the agenda grouped by when My day — today and next up first, then the agenda.

  • Header — a greeting with today's date, Next up (the next open activity, click to open it), Calendar, New activity (shortcut n) and the My queue / Everyone scope.
  • Today, hour by hour — a ribbon of today's timed activities, including any that have already slipped into Overdue, with a Now marker. With nothing timed it reads Nothing timed today — a clear run.
  • Agenda — time-ordered sections: Overdue, Today, This week, Later and No date. Each card shows the type, title, a verdict chip, the regarding record and the time, with Complete beside it. Each section starts with up to 50 rows; Load more fetches the next page without repeating rows. Counts continue to show the full matching total.

Inbox

Inbox: the list on the left, the selected activity's brief on the right Inbox — work through the list; the selected activity opens beside it.

  • List — every activity in scope with its type, regarding record and time, grouped by bucket (Overdue, Today, Upcoming, No date). Use ↑ and ↓ to move between rows and Enter to open one. Undated work never becomes overdue.
  • Brief — select a row to open it beside the list: description, regarding record, participants (labelled Staff or Contact), schedule, owner and other open activities on the same record, with Complete or Reopen, Edit, Open full record and the reschedule shortcuts. Until you pick one it reads Select an activity.

In both views

  • Search activities — searches titles, notes and locations, narrowing the feed and its counts together. Changing search or filters resets loaded pages.
  • Filters — the bucket filters (Overdue, Today, Upcoming, No date) carry the real scoped counts even when the list is capped; the type filters follow. Click a filter again to clear it.
  • More filters — Owners (with open and overdue counts per person), Regarding kind, Status and Favourites. Each toggles: click once to filter, again to clear. Picking an owner switches the scope to Everyone.
  • Select and act in bulk — tick activities to show the bar for Selected activities: complete or delete them together. Completing — one activity or a selection — shows a toast with Undo, which reopens what was just completed with the status it had.
  • Detail drawer — in My day, select a card (or focus it and press Enter or Space) to open the drawer with the same brief as Inbox. Edit opens the editor in a modal without leaving the workspace. Reschedule moves it to Tomorrow or Next week at the same time of day, or dates undated work Today. Esc closes it.

Switching view

An Activities layout switch in the page header (Inbox / My day) changes the view and remembers it for you; it works from the keyboard and announces the current choice. You can also pick it on Settings → Calendar under Your views. Until you choose, the company default from Admin → Settings → Scheduling → Default activities view applies (My day on a new installation).

There is no snooze, no SLA, and no "due date" concept — an activity has a start time, and overdue means its end time (or its start when no end is set) has passed while it remains open. Activities regarding a Facility show without a link (facilities have no page). The Calendar plots the same activities on a day, week or month grid.

Activity Detail

Route: /activities/{id}

The activity page follows your activities view, so it reads like the workspace you came from:

  • With Inbox — a record brief. The header shows the type icon, the title, a verdict badge (Overdue, Today, Scheduled, Undated, Done or Cancelled) and a line with the type, status, priority and owner. Below are When (in your time zone), Regarding, the notes and the attendees, Others on this record, custom fields and files, and the Timeline.
  • With My day — a run sheet. Run lists the steps in order — Logged, Starts, Ends and Complete (Waiting until it is done) — with a Now marker between them, then the notes and the History. The side column holds the actions, Reschedule, the regarding record and the People taking part.

In both, the actions are the same: favourite, print, Complete (or Reopen a completed activity), Edit and Delete (shortcut d, with a confirmation), and the Reschedule shortcuts (Tomorrow, Next week, and Today for undated work); Edit sets any other time. Completing and reopening each show a toast with Undo. Participants are labelled Staff or Contact, and the regarding record links to that record in the same tab.

Adding and Editing Activities

There is one activity editor. The quick-create modal (New activity on the workspace, the calendar and every record's Activities tab), the calendar's edit modal and the full-page form at /activities/create and /activities/{id}/edit share the same editor and save behaviour. The compact modal keeps optional fields under More details, including participants; the full page places participants beside the owner. Only custom fields are page-only: the modal's Open full form link carries any regarding record across.

The editor is grouped into:

Expand More details for the regarding record, status, priority, location, notes, reminder and repeat options.

  • Title (required) and Type — the types from the Activity Type list, as a row of buttons with their icons.
  • When — Starts and Ends, an All day switch (all-day activities run from local midnight to 23:59), duration buttons (15m, 30m, 1h, 2h) and Clear dates. A line under the fields names your time zone and summarises the schedule, for example Times in Europe/London · 02/11/2026 09:00–10:00 · 1h. Moving the start keeps the end after it. Leave both dates empty for an undated to-do; it waits in the No date bucket and the calendar's Unscheduled tray.
  • Who — Owner (required; Change reopens the search and Assign to me puts it back on you) and Participants: colleagues, and — when the activity regards an account — that account's contacts. Each suggestion and each chosen participant is labelled Staff or Contact.
  • More details → Regarding — a record type (Account, Catalogue Item, Asset, Rental, Vehicle or Facility) and then the record itself. Clearing the record also clears the type.
  • More details → Details — Status, Priority, Show as (Free or Busy), Location and Notes.

Times are entered and shown in your time zone and stored as exact moments, so the same activity reads the same on the calendar, the workspace, the activity page and the editor. Saving with status Completed marks the activity done everywhere; changing a completed activity back to another status reopens it. Every activity has an owner — saving without one is refused with Choose who owns this activity.

On the full page, choose Create activity or Save changes; Signals returns you to the activity's detail page. The action bar shows Unsaved changes until you save.

Form Fields

Field Description
Title Activity title or summary (required)
Type Activity type, from the Activity Type list (Settings → Lists)
Starts / Ends Scheduled start and end, in your time zone
All day Runs the activity from local midnight to 23:59 on the chosen days
Owner The responsible user (required)
Participants Who takes part: staff (users with a linked account) and contacts of the regarded account, each labelled by kind
Regarding The record the activity relates to: a type, then the record itself
Status Current status; Completed marks it done
Priority Low, Normal or High
Show as Free or Busy
Location Where the activity takes place
Notes Detailed notes or body text
Custom Fields Any custom fields defined for activities (full page only)

Activity type icons

Each Activity Type entry has an icon — Task, Call, Email, Meeting, Note, Letter or Fax. Pick it in Settings → Lists → Activity Type → Edit; it is used on the calendar, the workspace and the editor.

Permissions

Permission Description
activities.access Access the activities module
activities.view View activity details
activities.create Create new activities
activities.edit Edit existing activities
activities.delete Delete activities
activities.complete Mark activities as complete

Scoped Activity Tabs

Activities can be viewed in context on related record pages:

Record Tab Shows
Account /accounts/{id}/activities Actionable activities linked to this account, with the commitments timeline in a Commitments disclosure. History diagnostics sit behind Data freshness.
Catalogue item /catalogue-items/{id}/activities Activities linked to this catalogue item; New activity opens the quick-create modal for it
Asset /assets/{id}/activities Activities linked to this asset; New activity opens the quick-create modal for it
Rental /rentals/{id}/activities Activities linked to this rental; New Activity opens the quick-create modal for this rental
Vehicle /fleet/{id}/activities Activities linked to this vehicle; New activity opens the quick-create modal for it
Credit note /credit-notes/{id}/activities Activities for the invoice account, with financial events and audit history in Commitments; New activity is prefilled for that account
Payment /payments/{id}/activities Activities for the invoice account, with financial events and audit history in Commitments; New activity is prefilled for that account

All seven tabs use the workspace activity row, verdict chip and inline Complete action. Select a row to open the same activity drawer, including other work on the same record. The list supports Load more; the compact thread in a drawer uses the same list without opening another drawer inside it. Completing work in that thread refreshes the workspace counts and resets loaded pages.

The activity list requires permission to view both activities and its subject. Account, payment and credit-note commitments remain available to readers authorized for those records when the activity list is unavailable. Account rows follow account privacy rules: readers without contact-PII access see a generic activity label; privacy-restricted and purge-pending accounts show retained activity labels. Those rows omit owner details, record links, detail drawers and activity controls.

New activity on a tab needs activities.access and activities.create. The wizard is prefilled with the subject, and the list updates when the activity is saved. Credit-note and payment tabs use their invoice account as the subject, so those activities appear in both document tabs and on that account’s Activities tab. Some records also have a similarly named tab that shows the record's change history rather than CRM activities:

Record Tab Shows
Account /accounts/{id}/activity (Activity) A 12-month activity density chart and the account's audit timeline
Invoice /invoices/{id}?tab=activities (Activity Timeline) The invoice's audit timeline; /invoices/{id}/activity redirects here
Equipment test /equipment-tests/{id}/activity (Activity) The test's audit timeline
Rental project /projects/{id}/activity (Project changes) Changes to the project and its rentals
Rental /rentals/{id}/action-log The rental's commitments and action log

Activity payloads

Requests and responses link activities with subject: {type, id}. include=subject adds the linked resource's name inside that group. owner_id identifies the responsible user. An omitted subject retains the link during an update; a null subject clears it.

Use string values for priority (low, normal, high), status (scheduled, completed, cancelled, held) and time_status (free, busy). type_id selects an Activity Type list entry; activity_type_name provides its display name. Webhook activity payloads and MCP tools use this shape too. Subject filters are filter[subject.type][eq] and filter[subject.id][eq]; sort=status orders by status.

Completion and timezones

status determines completion. Creating or updating with status: "completed" sets completed true and records completed_at (UTC) and completed_by_id (the acting user). Changing to another status clears both fields. If a payload includes completed, it must agree with the resulting status; a disagreement returns 422. Repeating Complete or Reopen leaves timestamps unchanged and emits no additional transition event.

Forms read wall-clock times in your profile timezone, with the company timezone and then UTC as fallbacks. They convert to UTC for persistence; the activity page and calendar convert the instant back for display. Workspace Today ends at your next local midnight, including daylight saving changes. Cached bucket counts are separated by timezone and local date. For example, 09:00 on 1 July in Asia/Singapore is 01:00Z in API responses.

API and MCP

Every workspace action has an API equivalent under /api/v1/activities (see the API reference):

Workspace action REST MCP tool
List / filter (scope, owner, type, status, regarding kind, bucket) GET /api/v1/activities with filter[owner_id][eq], filter[type_id][eq], filter[status][eq], filter[subject.type][eq], filter[completed][eq], filter[starts_at][lt] / filter[starts_at][gte] list-upcoming-activities, or execute-endpoint
Favourites facet GET /api/v1/activities?favourites=1 execute-endpoint
Open a row GET /api/v1/activities/{id} execute-endpoint
New activity POST /api/v1/activities (POST /api/v1/activities/bulk for many) create-activity, bulk-create-activities
Edit PUT or PATCH /api/v1/activities/{id} execute-endpoint
Complete / bulk complete POST /api/v1/activities/{id}/complete or POST /api/v1/activities/bulk_complete complete-activity, bulk-complete-activities
Reopen POST /api/v1/activities/{id}/reopen (activities.edit) reopen-activity
Delete / bulk delete DELETE /api/v1/activities/{id} per activity execute-endpoint

Reminders and overdue work

The shared editor offers No reminder (disables advance reminders), At the start, 15 minutes before (default), 1 hour before, and 1 day before. Timed reminders use the activity’s start instant. All-day reminders run at 09:00 in the owner’s timezone, falling back to the company timezone. The tenant scheduler checks every five minutes, so delivery follows the next check. Undated, completed and cancelled activities do not send reminders.

A reminder is sent once for its schedule. Changing the schedule, owner or reminder setting rearms it. Open work whose end (or start when no end is set) has passed receives at most one overdue nudge per owner-local date. Notification settings and personal preferences apply to both in-app and email delivery; unread activity notifications can appear in the daily digest. The activity.overdue event can trigger an account workflow for an activity linked to an account.

Calendar API and tools

  • GET /api/v1/activities/calendar?from=2026-11-01&to=2026-11-30 lists overlapping activities with cursor pagination; optional owner_ids[] narrows the owners. The list-calendar-events tool uses the same query.
  • POST /api/v1/activities/bulk_complete accepts activity_ids (up to 100). bulk-complete-activities exposes the same operation.
  • POST /api/v1/activities/{activity}/assign accepts a required owner_id; assign-activity uses the same action.
  • list-upcoming-activities excludes completed activities by default. Set open_only: false to include them.

Calendar windows, partial-update semantics and bulk result shapes follow API conventions. Explicit null clears nullable fields on an update; omitting a field retains it. An owner is required and cannot be cleared. The response includes reminder_minutes_before and the UTC remind_at instant.

Activity API and MCP responses redact subject.name and participants[].account_name when the recipient lacks account identity access or the token lacks accounts:read. Webhook payloads apply the same recipient identity rule. Identifiers remain available for joining permitted records.

Repeating activities

All activity editors offer Repeat with daily, weekly and monthly frequencies, an inclusive Repeat until, a total Repeat count (1–366, including the first activity), and a Repeat timezone. Without a count, up to 366 occurrences are allowed. The calendar materialises eight weeks ahead and extends the horizon daily. Each occurrence has its own owner, participants, completion state, reminders and audit history. Moving or deleting one occurrence leaves the other occurrences intact.

On an existing series, This activity edits only the selected occurrence. This and following splits the series from that occurrence, replaces following scheduled occurrences, and keeps earlier activities and work with another status. Set Does not repeat with that scope to stop repeating. See Calendar → Repeating activities.

Recurrence API fields

Create accepts recurrence_rule (daily, weekly, monthly or null), recurrence_until (YYYY-MM-DD), recurrence_count (1–366) and recurrence_timezone (IANA identifier; company zone when omitted). A repeating activity requires starts_at. Read responses include these fields and recurrence_parent_id, which identifies the anchor for a materialised occurrence. Update defaults recurrence_scope to this; use this_and_following to change repeat settings or split a series. An omitted field retains its value; null clears a nullable repeat option. The create-activity MCP tool accepts the same repeat fields.

{
    "title": "Weekly crew call",
    "starts_at": "2026-11-02T09:00:00Z",
    "ends_at": "2026-11-02T09:30:00Z",
    "recurrence_rule": "weekly",
    "recurrence_timezone": "Europe/London",
    "recurrence_count": 12
}

Deleting the series anchor stops further generation and keeps its materialised activities as independent records. Deleting a generated occurrence does not recreate it.

Additional form guidance

When no activity exists and no search is active, My Day and Inbox show No activities yet with the permitted creation action instead of empty buckets and filters.