> 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

Invite team members to your Coupler.io organization or workspace. Learn how to add users, assign roles, and manage access to shared data flows.

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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/account-management/workspaces-and-organization/how-to-add-user-to-organization-or-workspace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.