# Invite And Onboard A User

Use this guide to add a new person to your organization.

## Before you start

* You need user invite access in Dashboard.
* A default invite role should be configured in organization settings.

## Steps

1. Open `Dashboard > Users`.
2. In `Invite a new user`, enter name and email.
3. Submit the invite.
4. Ask the user to accept the invite link/email.
5. After acceptance, open the user card.
6. Assign or adjust roles as needed.
7. Confirm status and remote/onsite flags are correct.

## Optional admin checks

* Ensure the user is assigned to the correct team.
* If needed, export user data from the user card actions.

## If something does not work

* Invite not visible: check your permissions.
* Wrong access after invite: verify role assignment and organization role definitions.

## Screenshot Checklist (GitBook Publishing)

* [ ] Capture the `Users` page with invite panel visible.
* [ ] Capture invite form filled before submission.
* [ ] Capture the invited user record after acceptance.
* [ ] Capture role assignment state on the user card.
* [ ] Redact personal data (email, names, IDs) before publishing.

## Screenshot Placeholders

* `TG-USERS-01-context`: Dashboard users page with invite panel.
* `TG-USERS-02-action`: Invite form populated before create.
* `TG-USERS-03-result`: User visible in list with active status.
* `TG-USERS-04-roles`: Role assignment state on user card.


---

# Agent Instructions: 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:

```
GET https://xdbx.gitbook.io/axon/task-guides/invite-and-onboard-a-user.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
