CRM & Addresses
CRM records in brief, the global address list across accounts, rentals, and invoices, plus practical import and export how-tos.
Overview
CRM in Signals centres on Accounts — contacts, companies, venues, and users — plus Activities, Calendar, and Conversations & mentions. Addresses are a first-class polymorphic entity: every address belongs to an Account, Rental, or Invoice. There are no orphan addresses.
| Nav item | Route | Permission |
|---|---|---|
| Accounts | /accounts |
accounts.access |
| Addresses | /addresses |
addresses.access |
| Activities | /activities |
activities.access |
Account CRUD, merge, and detail tabs remain on the Accounts page. This page covers the Global Address List, address fields, and import/export.
Address fields
| Field | Notes |
|---|---|
Label (name) |
e.g. “Head Office” |
| Street | Required when creating via the global form / create DTO |
| City, County / State, Postcode | Standard postal fields |
| Country | Active country from the countries list |
| Type | List Address Type — seeded values include Billing, Shipping, Primary, Registered |
| Primary | Checkbox; on an account, checking Primary clears other primaries for that account |
| what3words | Optional; lookup/geocode when the integration is configured, otherwise stored as text |
| Latitude / Longitude | Set manually, via geocode, or by dragging the map marker |
Global Address List
Route: /addresses
Permission: addresses.view
Browse every address whose parent you can view (accounts.view / rentals.view / invoices.view). If you cannot view any parents, the list is empty.
Rental delivery and collection pickers are narrower than the global list. By default, operators can select addresses belonging to the chosen customer or venue. The separate addresses.tenant-book.use ability permits reuse from the visible tenant address book. Merely knowing an account or address ID never grants cross-account selection. An address created from the rental form remains attached to the selected customer account.
Live references and immutable snapshots
Rental drafts and editable operational records save live delivery and collection address IDs. Correcting the selected address therefore changes what an editable rental shows without copying stale text into every draft.
An issued tax document, finalized customer document, dispatch manifest, or completed delivery receipt must instead carry the resolved address text in its immutable revision, event, or artifact. Those released facts must not be regenerated from a later-edited account address. A correction creates a new revision or correction record; it does not rewrite the original record. Integrations should treat rental address IDs as mutable planning references and released document or dispatch payloads as historical snapshots.
Filters & columns
- Type chips (
?type=): All · Account · Rental · Invoice - Search: name, street, city, postcode
- Default columns: Name (with street secondary), Belongs To, City, Postcode, Country, Primary, Created
Toggleable extras include Street, County, Type, what3words, Updated
Belongs To shows a label such as Account: Acme Corp and links to the parent when permitted.
Actions
| Action | Detail |
|---|---|
| Add Address | /addresses/create — pick parent type and record, then address fields |
| Edit | /addresses/{address}/edit — parent is read-only after create |
| Delete / bulk delete | Requires addresses.delete and permission to edit the parent |
| Export | Toolbar CSV of the current filtered, visible columns (see below) |
Keyboard: n opens Add Address when you have addresses.create; x exports when available.
Addresses on an account
| Route | Role |
|---|---|
/accounts/{account}/information |
Primary UI — Addresses panel alongside emails, phones, and links |
/accounts/{account}/addresses |
Dedicated table list |
/accounts/{account}/addresses/create |
Create |
/accounts/{account}/addresses/{address}/edit |
Edit |
After save from the account form, Signals returns to the Information tab. Mutations also require the parent’s edit permission (e.g. accounts.edit), not only addresses.*.
Geocoding on the form
On the global Add Address or Edit Address form:
- For a new address, choose Parent Type and Parent Record under Belongs To. The parent is read-only after creation.
- Enter a label, then use Find an address to search by street, postcode or place. Select Find, then pick a match to fill the address fields. You can also enter them by hand.
- Check Location. Location found means a building or house-number match; Approximate location needs a pin check. No match found and Geocoding unavailable offer a retry or manual coordinates.
- Drag the map pin, click the map or enter latitude and longitude to refine the location. Pin placed by hand identifies a manual location; Coordinates saved identifies existing coordinates, and Not located yet means none are set.
- Expand More details for address Type and Primary address, then choose Add Address or Save changes.
The account-specific address form also provides these geocoding controls:
- Geocode from Address — builds a query from street, city, county, postcode, and country
- Lookup — resolves a
word.word.wordwhat3words string when configured - Map preview (OpenStreetMap) — drag the marker or click the map; Open in OSM for an external view
Import & export how-to
A. Quick CSV from a list toolbar
On /accounts and /addresses, use the DataTable Export control:
- Apply the search, type chips, and column visibility you want.
- Click Export (or press
xwhere bound). - Download a CSV named like
addresses-YYYY-MM-DD.csv(always includes anIDcolumn).
This is a synchronous stream of the current filtered result set — CSV only.
B. Exports (full formats)
Route: /admin/settings/exports
Permissions: exports.access → exports.view → exports.create
- Open Admin → Data → Exports → New export.
- Choose source model (
accountsoraddresses) or a live filter. - Pick format: csv, xlsx, json, or pdf.
- Select columns and optional filters; submit.
- Small jobs download immediately (sync threshold, default 1000 rows); larger jobs queue on the
exportsqueue — download from the job list when complete.
Exports run as the creating user (warehouse scope and column visibility, including costs.view gating where relevant).
C. Import wizard (accounts & addresses)
Imports are disabled by default; enable them with SIGNALS_IMPORTS_ENABLED=true (see Imports).
Routes: /admin/settings/imports, /admin/settings/imports/create, /admin/settings/imports/{import}/wizard
Permissions: imports.access → imports.view → imports.create (imports.undo for plan undo)
Core import targets include accounts and addresses. Stages: Upload → Map → Validate → Preview → Commit.
Practical steps
- Admin → Data → Imports → New import.
- Upload — choose target Accounts or Addresses, drop a CSV / XLSX / JSON file, Upload & parse, review detected columns, continue.
- Map — map source columns to target fields; optionally apply a mapping profile, Auto-Map, or accept suggestions. Set a conflict strategy (Skip, Overwrite, Merge, Flag) and duplicate-match fields (defaults: accounts →
name; addresses →street). - Validate — fix or export the error CSV if rows fail.
- Preview — confirm mapped records, then Commit (pause / resume / cancel when permitted).
Address parent columns
Addresses need a parent. Map exactly one of these (first wins), or rely on a batch-level polymorphic default:
| Column | Resolves |
|---|---|
account_id |
Account by id |
account_email |
Account with that email |
rental_id / rental_number |
Rental |
invoice_id / invoice_number |
Invoice |
Missing or invalid parents fail the row — imports never create orphan addresses. Address imports do not call external what3words geocoding per row (resolveWhat3Words is off).
Accounts import through the same create and update path as the app (schema fields such as name, account_type, currencies, tax fields, tags, etc.).
Permissions (addresses & data)
| Permission | Purpose |
|---|---|
addresses.access / view / create / update / delete |
Global address area and UI |
addresses.tenant-book.use |
Select a visible address not owned by the rental's chosen customer or venue |
Parent *.edit (e.g. accounts.edit) |
Create/update/delete addresses on that parent |
imports.* / exports.* |
Import wizard and Exports |
Additional form guidance
Address create and edit forms include configured Address custom fields, including the address dialog opened from a rental. Required fields are checked when saving.
Related
- Accounts — CRM entity CRUD and detail tabs
- Conversations & mentions — conversation panel on accounts, rentals and invoices
- Countries — country list used by address forms
- Lists — manage the Address Type lists
- Global search — Cmd-K does not search addresses; use
/addressessearch orfilter[search]on searchable APIs