Street integration

The Street integration is for agency accounts. Only an organisation Owner or Admin can connect it. Direct landlords do not have a Street connection in Lettie.

The setup has five stages: Connection, Data review, Branches, Onboarding and Sync.

1. Connect the correct Street environment

  1. Open Organisation > Integrations.
  2. Open Street and start setup.
  3. Choose Staging for non-production Street data or Production for the live agency account.
  4. In Street, open Settings > Account Administration > Applications and generate a dedicated API key for Lettie.
  5. Copy the value directly into Lettie.
  6. Select Test connection.
  7. When the test identifies the expected account, select Connect and continue.

Use only the permissions Street tells you are required for this integration. Do not invent a key value or reuse somebody's personal credential.

Important: Production contains live agency data. Check the environment before connecting; a later API-key replacement keeps the existing environment.

The key is stored securely and is not shown again.

2. Review data

Data review loads a snapshot of Street properties, tenants and branches. Lettie shows likely matches and records that may be new.

  1. Check the totals against the Street account.
  2. Review every suggested match, including high-confidence suggestions.
  3. Leave an uncertain match unconfirmed.
  4. Select Confirm and continue.

Lettie skips conflicts instead of overwriting an unrelated local record. A skipped record can be corrected and retried later.

3. Map branches

For each Street branch you want to use:

  1. enable the branch;
  2. map it to the correct existing Lettie branch, or choose Create a new Lettie branch; and
  3. select Save and continue.

Do not map two genuinely different offices together simply because their names are similar. Branch mapping affects portfolio access for Members and Viewers as well as later synchronisation.

New provider branches can require review when they appear. Open Manage branches after setup to update the mapping.

4. Choose onboarding

Choose how the first import should treat tenants:

  • Import without messaging creates or links records without sending a welcome message; or
  • Send welcome messages now begins the selected tenant onboarding during import.

Turn on Daily automatic sync if Lettie should reconcile Street data every 24 hours. This is a daily interval, not a guaranteed fixed time of day.

Select Start initial sync only after the environment, matches, branch mappings and messaging choice are correct.

5. Monitor the first sync

The sync is queued and may continue while you remain on the page. Review:

  • records created or linked;
  • records skipped with warnings; and
  • any operation that needs attention.

Select Finish setup when the run has completed and the summary is sensible.

Day-to-day controls

The connected Street card gives Owners and Admins access to:

  • Integration status
  • Daily automatic sync
  • Review and sync
  • Manage branches
  • Replace API key
  • Disconnect

Pausing the integration stops Street calls while keeping stored links and setup. Resume it once the underlying issue has been corrected.

Use Review and sync before a manual reconciliation. It lets you see what Lettie expects to change before the queued work runs.

Replace an expired API key

  1. Create a fresh dedicated key in the same Street account and environment.
  2. Open Replace API key.
  3. Enter the value exactly and test it.
  4. Save only when the expected account is confirmed.

The environment is locked during a normal key replacement to protect existing record links. If the agency is moving to a different Street account or environment, treat that as a separate relink rather than disguising it as credential rotation.

Recover from a setup or sync problem

The wizard keeps successful connection details, links and mappings when a later stage fails.

  • Use Retry data review if the review snapshot could not be loaded.
  • Use Retry branches if branch discovery failed.
  • Use Retry sync after correcting a failed first import.
  • If the run completed with warnings, review the affected records and retry the reconciliation.
  • For a failed delivery or queued operation, open its status on the Street card and use the available retry action.

Retries use the stored Street identities to avoid creating the same property or tenant again. Do not delete a good import simply because another record failed.

Repairs and emergency fallback

Street can receive the supported context when a maintenance report is handed off. Lettie's maintenance workflow still decides when the report needs the agency or a downstream job; it does not create a Street outcome for every conversation.

The out-of-hours emergency ladder remains separate. Emergency work never waits for a quote approval or a scheduled Street synchronisation. Configure both areas under Organisation settings and notifications.

Disconnect Street

Open Disconnect, read Disconnect Street?, then confirm only if the connection should end.

Disconnecting removes authentication and stops future synchronisation and writes. Properties, tenants, branches and reports already imported into Lettie remain. Their saved Street identities allow the existing history to stay understandable.

Last Edited: August 10, 2026