Address record with this UUID not found

Do you click on a propform link from an onOffice email template and get the error message “Address record with this UUID not found” (or the equivalent for properties)? This is almost always due to one of four causes.

> 💡 Before you dig deeper: first check whether the UUID in the URL is complete (?address[ID]=... with a capital I and D, ?estate[Id]=... with a capital I, lowercase d). Typos in the bracket notation are cause #0.

Diagnostic sequence (4 levels)

Go through the four levels in this order — starting with the most common causes.

1. Record has been deleted

Open onOffice → Addresses / Properties module
Search for the UUID (or the corresponding record)
If no longer there → Record was deleted manually or removed via a process manager auto-delete job
Solution: Restore via onOffice Administration → Recycle Bin (if enabled), or create a new record

2. API user has no read permissions for the module

onOffice → Tools → Settings → Administration → API Users → select the propform API user
‘Rights’ tab → check whether ‘Addresses’ or ‘Properties’ has the ‘Read’ tick selected
Solution: Tick the box + save. Takes effect immediately, no cache.

3. Employee/group record permissions too restrictive

In onOffice, records can be restricted to specific employees or groups (sharing).

Open the record in onOffice → “Permissions” tab (or “Record permissions”)
Check whether the API user (or their group) has access
Solution: Add the API user to the authorised groups or expand the sharing settings

> 💡 For larger onOffice versions with the Groups module: The API user often needs the “All” group or a specific sharing group.

4. Record is marked as “Private” + API user is not the owner

Open record → Check the “Private” tick box
If active: Only the owner (the employee who created it) can see the record; everyone else — including API users — is excluded
Solution: Uncheck the box, or change the owner to the API user

Helpful test setup

If you want to reproduce the error systematically:

Create a test record in onOffice
Note down the UUID
Call up the test form using the URL ?address[ID]=<UUID>
Works → Record, permissions and API user are generally OK
Does not work → Check one of the four levels above

propform.ioHilfe