> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/agents/onboarding-agents/manual-registration.md).
# Manual Registration
### Overview
Use **Register agent** when you need to add agents to BalkanID one by one — for example, automation actors that are not yet discovered from an application integration.
Registration creates agents in BalkanID so you can assign owners and associate the identities and credentials the agent has access to.
### Before You Begin
* Agents (Early Access) must be enabled for your tenant.
* You must have a Reviewer, Risk Manager, or Administrator role.
* The owner you assign must be an employee record in BalkanID.
{% hint style="info" %}
Reviewers can register agents with themselves as the owner. Administrators and Risk Managers can select any employee as the owner.
{% endhint %}
### Procedure
1. Login to the BalkanID application and switch to the tenant where you want to register agents.
2. Head to **Configure → Agents**.
3. Click **Register agent**.
4. Fill in the agent details:
* **Name** (required)
* **Description** (optional)
* **Agent type** (required)
* **Owner** (required)
5. Click **Add Agent** to add the agent to the queue.
6. Repeat steps 4–5 for additional agents as needed.
7. Review the **Agents to be added** queue.
8. Click **Save** to submit the registration.
{% hint style="info" %}
You can register up to **10** agents per save. Registration is processed asynchronously.
{% endhint %}
### Result
After save completes, the new agents appear on the **Agents** page. You can then open an agent to review details, update the owner, and [map identities and credentials](/agents/mapping-identities-and-credentials-to-agents.md) the agent has access to.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.balkan.id/agents/onboarding-agents/manual-registration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
