TL;DR: Enable the Companies House integration so that Uku automatically fills in client data when you enter a UK company name. You only need to set it up once -- after that, the custom fields appear automatically for all new clients.
Important: Once enabled, Companies House data syncs automatically every 24 hours and will overwrite manual changes to task dates and assignees. Read the 'Ongoing sync behaviour' section below before editing Companies House tasks manually.
Who can do this
Users with permission to add clients
Only applicable to clients registered in the United Kingdom
Setting up the integration
Select Clients from the main menu.
Click Add client.
Select United Kingdom as the country.
In the Country field area, click the Setup Companies House fields button.
You only need to perform step 4 once. The next time you add a client with United Kingdom selected, the Companies House custom fields will already be visible.
Using the integration
After setup, Companies House custom fields appear automatically when adding a UK client. Enter the company name, and Uku fills in the data automatically based on the information registered with Companies House.
Setting up recurring tasks
If you want Companies House-related tasks to appear automatically on your dashboard in the future, add a recurrence in the task's Repeat section. Learn how to set a recurrence.
Ongoing sync behaviour
Warning — automatic sync overwrites manual edits. Companies House data syncs automatically every 24 hours. Each sync cycle overwrites task due dates and reassigns tasks to the client's primary member. If you have manually changed dates or assignees on Companies House tasks, those changes will be lost on the next sync.
The 24-hour sync cycle
Every 24 hours, Uku syncs data from Companies House for all connected clients. During each sync cycle:
Task due dates are recalculated from Companies House filing deadlines.
Task assignees are reset to the client's primary member.
Any manual edits you made to these fields since the last sync are replaced.
Understanding the primary member
Each client in Uku has a primary member -- the team member mainly responsible for that client. The Companies House sync uses the primary member to determine task assignment:
Each client has a primary member set on the client record.
Every sync cycle reassigns all Companies House tasks to the primary member.
To permanently change who is assigned to Companies House tasks, change the primary member on the client record -- not on individual tasks.
Troubleshooting
The "Setup Companies House fields" button does not appear -- Make sure you have selected United Kingdom as the country for the client. The button only appears for UK clients.
Custom fields are not visible for a new client -- Confirm that you completed the one-time setup by clicking Setup Companies House fields on a previous client. If not, add any UK client and click the setup button.
Company data is not auto-filled -- Verify that the company name you entered matches the name registered with Companies House. Try the exact registered name or company number.
