Remove Listings Agents

Overview

To remove a listing agent, click Listings in the left menu → open the Agents tab → tick each agent you want to remove → click the Actions button → Delete → confirm. Manage the same list to add or edit an agent.

Remove an agent

Open the Agents list

From the left menu, click Listings, then open the Agents tab (alongside Active, Pending and Completed). The table lists each agent with their name, email, linked accounts and portfolios.

Select the agents to remove

Tick the checkbox at the start of each agent's row — select one or several.

Open the Actions menu and delete

Click the Actions button above the table, then click the red Delete in the menu that opens. (Choose Clear Selection instead if you picked the wrong rows.)

Confirm

A browser dialog warns that the deletion can't be undone — click OK. A toast confirms the agent (or the number of agents) was deleted, and the list refreshes.

Note: Deleting an agent is permanent — there's no undo, and to bring one back you'd have to re-create it and re-enter all its details and linked accounts. If the agent still appears on any live listings, open those listings and update their agents first.

Add or update an agent instead

Start a new agent

On the Agents tab, click Add agent (top right) to open the Property agent details form.

Link at least one account

Under Listing platform accounts, tick the connected Trade Me and/or Realestate.co.nz accounts this agent publishes through. Every agent must be linked to at least one account.

Scope the agent to portfolios (optional)

In the Portfolios section, leave Available for all portfolios ticked to make the agent available everywhere, or untick it to pick at least one specific portfolio. You can also upload an optional square Agent logo for third-party listing ads.

Enter the required details

Fill in the agent's Full name and Email — both required. Phone number, Agency name and Real estate authority ID are optional.

Add the Realestate.co.nz details

If you linked a Realestate.co.nz account, extra fields appear — choose a Class code (required), and optionally a Job title and Website URL.

Save

Click Save. Keyhook syncs the agent to each linked account and flags any account that failed to sync.

Edit an existing agent

To change an agent, click their row on the Agents tab — the same form reopens with their details for you to update and Save.

Frequently asked questions

Where do I manage listing agents?

Click Listings in the left menu and open the Agents tab. Every agent profile for your agency lives there — that's where you add, edit and remove them.

Can I remove several agents at once?

Yes. Tick every agent you want to remove, click the Actions button, choose Delete once, and confirm — the toast tells you how many were deleted.

Can I undo deleting an agent?

No — deleting is permanent. To bring an agent back you have to re-create them with Add agent and re-enter their details and linked accounts.

What is a listing agent used for?

An agent profile is the person advertised on a listing. When you publish a listing to Trade Me or Realestate.co.nz, you pick which agents appear on it — only agents synced to that account can be selected.

Do I have to delete an agent to stop advertising them on a listing?

No. You can simply not select that agent when you edit the listing. Deleting removes the agent from your agency entirely; deselecting just drops them from one listing.