---
title: "Agent Registration Requests"
description: "Approve or decline new agents before they join your organisation"
category: "Administration"
subcategory: "Administration"
last_updated: "2026-10-29"
source_url: "https://docs.xeox.com/administration/wyLDjDBC1xLUFoXLAzdg11/agent-registration-requests/8Y7fsnLmVLzeHq2WMVxpe8"
---

# Agent Registration Requests

When **Approve new agents automatically** is off (**Administration → Settings → Agent**, see[

**Organisation and Agent configuration**](https://docs.xeox.com/knowledge-base/1tsADjnvsqfNJwHKuwpWZK/organisation-and-agent-configuration/7ZGY29XEWuzLUypff9i8sn)), a newly installed agent doesn't join your organisation right away. It waits under **Administration → Agent Registration Requests** until someone approves it. That way, a leaked connection key can't bring unknown devices into your organisation.

## Approve or decline

The **Pending** tab lists the agents that are waiting, with their hostname, operating system, IP address, agent version and when they registered. Tick the ones you know and click **Approve** or **Decline** in the toolbar, or use the **…** menu of a single row.

![notion image](https://docs.xeox.com/media/b998972c8b95bf23.png)

An approved agent connects at its next check-in and shows up in **Devices**. A declined agent stays out.

## A device with this name already exists

If a device with the same hostname is already in your organisation, for example because Windows was reinstalled, XEOX asks what each new agent becomes:

- **New device**: a second device with the same name. Rename one later to tell them apart.
- **Take over**: the agent continues the existing device, with its history, tags and automations; the device's previous agent is signed out.

![notion image](https://docs.xeox.com/media/ceeb4005edf4516d.png)

The agents with a free name are approved as new devices in the same step.

## Approved and Declined

The **Approved** tab shows when each agent was approved and by whom, when it last signed in and how often. The **Declined** tab shows when and by whom an agent was declined.