> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/account-management/workspaces-and-organization/how-to-add-user-to-organization-or-workspace.md).

# Add user to organization or workspace

There are two ways to invite users, depending on what level of access you want to grant.

{% @arcade/embed url="<https://app.arcade.software/share/z8pv2O0LhxVNVYadYyZ1>" flowId="z8pv2O0LhxVNVYadYyZ1" %}

### Option 1: Invite to Organization <a href="#option-1-invite-to-organization-organization-owners-only-myavw" id="option-1-invite-to-organization-organization-owners-only-myavw"></a>

{% hint style="success" icon="user-key" %}
Role requirement: Organization Owner
{% endhint %}

**When to use this**: When you want someone to be an Organization Owner with full access to billing and all workspaces.

**Steps:**

{% stepper %}
{% step %}
From the Homescreen, go to Settings -> Organization → Organization Owners tab
{% endstep %}

{% step %}
Click the "Invite new user" button
{% endstep %}

{% step %}
Enter the person's email address
{% endstep %}

{% step %}
Click "Send Invite"
{% endstep %}

{% step %}
They'll receive an email invitation to join as an Organization Owner
{% endstep %}
{% endstepper %}

**Result**: Once the invitation is accepted, the person becomes an Organization Owner with access to all workspaces and billing settings.

***

{% @arcade/embed url="<https://app.arcade.software/share/DtVvH4lH8AupIs3D4cee>" flowId="DtVvH4lH8AupIs3D4cee" %}

### Option 2: Invite to Workspace <a href="#option-2-invite-to-workspace-organization-owners-and-admins-begmg" id="option-2-invite-to-workspace-organization-owners-and-admins-begmg"></a>

{% hint style="success" icon="user-key" %}
Role requirement: Organization Owner or Workspace Admin
{% endhint %}

**When to use this**: When you want someone to work in a specific workspace without organization-level access.

**Steps:**

{% stepper %}
{% step %}
From the Homescreen, go to Settings <i class="fa-arrow-right">:arrow-right:</i> Organization <i class="fa-arrow-right">:arrow-right:</i> Workspaces tab
{% endstep %}

{% step %}
Click "Manage" on the workspace where you want to invite the user
{% endstep %}

{% step %}
Click the "Invite new user" button
{% endstep %}

{% step %}
Enter the invitation details: email, name, and role ("Admin", "User", or "Guest".)
{% endstep %}

{% step %}
Click "Send Invite"
{% endstep %}

{% step %}
They'll receive an email invitation to join the workspace
{% endstep %}
{% endstepper %}

**Result**: Once the invitation is accepted, the person joins only the specific workspace with the role you assigned.

***

{% hint style="success" icon="link" %}

#### **Invitation details**

* The invitation link is valid for **14 days**. Before accepting, the user status is **Pending**.
* If the link has expired and wasn't yet accepted, you can **revoke** it and create a new one.
* **Pending** users ***are not counted*** towards your plan limit.
  {% endhint %}

{% hint style="info" icon="book-open-cover" %}
Read more about Coupler.io roles: [User roles in Coupler.io](/account-management/workspaces-and-organization/user-roles-in-coupler.io.md)
{% endhint %}

{% hint style="info" %}
Coupler.io allows adding multiple users to an organization. The number of allowed users to add depends on your billing plan. Check our [pricing page](https://www.coupler.io/pricing) for more details.
{% endhint %}


---

# 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.coupler.io/account-management/workspaces-and-organization/how-to-add-user-to-organization-or-workspace.md?ask=<question>&goal=<endgoal>
```

`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.