> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dcal/account/invite-teammates.md).

# Invite teammates

Invite anyone to your dCal workspace by email, with the Member or Admin role. See the invitation email, resend it, follow what your teammate does to join, switch between workspaces, and get a new team

Invite anyone with an email address to your dCal workspace, whether or not they are in your Dapta workspace. dCal emails them an invitation, they sign in with that address and click **Join workspace**, and they get the role you chose. This page covers both sides: what you do as an owner or admin, and what your teammate does.

> **💡 Tip:** People who already belong to your workspace in the Dapta app do not need an invitation: they can sign in at [app.dcal.ai](https://app.dcal.ai) and join as a **Member**. Invite them anyway when you want to choose their role first, for example **Admin**. Their first sign-in to dCal picks up the invitation with that role, with no **Join workspace** step. See [Members and roles](https://docs.dapta.ai/dcal/account/members-and-roles.md).

***

## Who can invite

Owners and admins. Members do not see the **Members** tab, and a member who opens it from a saved link sees **You don’t have access**. You can invite someone as a **Member** or an **Admin**. Nobody can be invited as an owner: ownership changes hands only through **Transfer ownership**.

***

## Send an invitation

**Step 1:** Go to **Settings** > **Members**, or open [app.dcal.ai/admin/settings/members](https://app.dcal.ai/admin/settings/members). Click **Invite member** at the top right.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-102962ced76838288cbadabe0db057c8b5e7e2e8%2Fdcal-invite-01-members-page.png?alt=media" alt="The Members tab with the three role descriptions, the Workspace members list with Jane Doe as the owner, and the Invite member button boxed"><figcaption><p><strong>Invite member</strong> sits above the list of workspace members.</p></figcaption></figure>

**Step 2:** In **Invite a member**, type your teammate's **Email**, pick a **Role** (**Member**, the default, or **Admin**) and click **Send invite**.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-62942c387166d1cc6ba604404217f276a41e34ff%2Fdcal-invite-02-invite-form.png?alt=media" alt="The Invite a member dialog with the line They get an invitation to join with the role you choose, the Email field filled with john@acme.io, the Role set to Member and the Send invite button boxed"><figcaption><p>An email and a role. That is all the form asks.</p></figcaption></figure>

**Step 3:** You see **Invitation sent.** Your teammate appears in the list with the status **Invited**, and dCal emails them the invitation.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-c06aef902483123bfbb01011ad374d7bed448041%2Fdcal-invite-03-pending-member.png?alt=media" alt="The Workspace members list with Jane Doe as the owner and, under her, a pending row for john, his email cut short, with the Invited status, the Member role and the Resend invite, Disable and Remove buttons"><figcaption><p>A pending invitation reads <strong>Invited</strong> until your teammate joins.</p></figcaption></figure>

The form has no name field, so the new row takes its name from the part of the address before the @: `john@acme.io` shows as john. Your teammate can set their own name once they join (see [Get a new teammate ready to host](#get-a-new-teammate-ready-to-host)).

| Message                                                                          | What to do                                                                                                |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Enter a valid email address.**                                                 | Check the address for a typo.                                                                             |
| **A member with that email already exists.**                                     | The person is already on the list, joined or invited, and nothing was sent. Find their row.               |
| **This workspace reached today’s invitation limit. Try again tomorrow.**         | Your workspace sent its 50 invitation emails for the day. Invite them tomorrow.                           |
| **Member added, but the invitation email could not be sent. Use Resend invite.** | Your teammate is on the list as **Invited**, but no email went out. Click **Resend invite** on their row. |

***

## The invitation email

dCal sends the email as soon as you click **Send invite**. It is written in the language of your dashboard at that moment, English or Spanish, not in your teammate's language. To send it in the other language, change **Language** in **Settings** > **General** before you send or resend it.

| Part    | In English                                                                                      | In Spanish                                                                                             |
| ------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Subject | Join {workspace name} on dCal                                                                   | Únete a {workspace name} en dCal                                                                       |
| Text    | "{Your name} invited you to join this workspace on dCal. Sign in with {their email} to accept." | "{Your name} te invitó a unirte a este espacio en dCal. Inicia sesión con {their email} para aceptar." |
| Details | **Workspace**, **Role** (Admin or Member) and **From** (your name)                              | **Espacio**, **Rol** (Administrador or Miembro) and **De**                                             |
| Button  | **Accept invitation**                                                                           | **Aceptar invitación**                                                                                 |

* The email shows your **Display name** in this workspace. Set it in **Settings** > **General** so your teammate recognizes you.
* The invitation stays open until your teammate joins or you remove it.

***

## Resend an invitation

**Step 1:** On the row of a pending invitation, click **Resend invite**. dCal sends the email again, in the language of your dashboard. You see **Invitation sent again.**

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-b26a2c58f679074b03ac2a606b98724949a838db%2Fdcal-invite-04-resend.png?alt=media" alt="The pending row for john in the Workspace members list with the Resend invite button boxed and the toast Invitation sent again. at the bottom right"><figcaption><p><strong>Resend invite</strong> shows only on rows that read <strong>Invited</strong>.</p></figcaption></figure>

Click **Resend invite** less than a minute after the last invitation and you see a red message instead.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-764ba652983a64c1f44302065a8afd1d2e982ca4%2Fdcal-invite-05-resend-limit.png?alt=media" alt="The Workspace members list with the red toast An invitation just went out. Try again in a minute. at the bottom right"><figcaption><p>One invitation per teammate per minute. Wait a minute and click again.</p></figcaption></figure>

| Message                                                             | What it means                                                                              |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Invitation sent again.**                                          | The email is on its way.                                                                   |
| **An invitation just went out. Try again in a minute.**             | An invitation went to this teammate less than a minute ago. Wait a minute and click again. |
| **At most 50 invitations a day per workspace. Try again tomorrow.** | Your workspace reached its daily limit. Resend it tomorrow.                                |
| **That member has no pending invitation.**                          | Your teammate already joined. Reload the page to see them as **Active**.                   |

The limits:

| Limit         | Value                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| Per teammate  | One invitation email per minute, new or resent.                                                               |
| Per workspace | 50 invitation emails a day, new invitations and resends together. The day runs from midnight to midnight UTC. |

> **💡 Tip:** Invited someone before dCal sent invitation emails? Their row still reads **Invited** and they never got an email. Click **Resend invite** to send it.

***

## Pending invitations and active members

|                   | Pending invitation                                                   | Active member                                                                                                      |
| ----------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Status            | **Invited**                                                          | **Active**                                                                                                         |
| **Resend invite** | Yes                                                                  | No                                                                                                                 |
| Role picker       | Yes. Your teammate joins with the role the row shows at that moment. | Yes                                                                                                                |
| **Remove**        | Cancels the invitation. The email no longer lets them join.          | Takes them out of the workspace. See [Members and roles](https://docs.dapta.ai/dcal/account/members-and-roles.md). |

To cancel an invitation, click **Remove** on its row and confirm in **Remove this member?**. You see **Member removed.**

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-94b108d2ad655df2b89b68d447032fe59438cd36%2Fdcal-invite-12-remove-member.png?alt=media" alt="The Remove this member? dialog with the text john loses access to this workspace. Their past bookings stay., and the Cancel and Remove buttons"><figcaption><p>The same dialog shows on a pending row, where <strong>Remove</strong> cancels the invitation.</p></figcaption></figure>

When your teammate joins, their row turns **Active**.

<figure><img src="https://3835013762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCy5rSNtQmtqYCGzJlNEB%2Fuploads%2Fgit-blob-b6925b5fcbc7b97a0214fddef08fe28bad4d5416%2Fdcal-invite-10-active-member.png?alt=media" alt="The Workspace members list with the teammate&#x27;s row, its name and email cut to a few letters, showing the Active status, the Member role and the Transfer ownership, Disable and Remove buttons"><figcaption><p>On an active row, <strong>Resend invite</strong> is gone.</p></figcaption></figure>

***

## What your teammate does

This part is for the person you invited, so you can share it with them as it is.

**Step 1:** Open the invitation email and click **Accept invitation**.

**Step 2:** Sign in with the address the invitation was sent to. If you are signed out, the Dapta sign-in screen opens first and brings you back. If you do not have a Dapta account with that address yet, create one at app.dapta.ai first (see [Sign in and set up](https://docs.dapta.ai/dcal/getting-started/sign-in.md)).

**Step 3:** The join page, headed **Join** and the workspace's name, tells you the role you are invited as, and that you keep your own account. Click **Join workspace**. **Not now** leaves without joining, and the invitation stays open.

**Step 4:** dCal opens the workspace. If you have no event of your own there yet, you first see **Create your first event**: create an event from a template, or click **Skip for now**. Your own workspace shows the same screen the first time you open it.

Once you have joined, the link in the email opens the workspace directly.

**Another way to join:** if you are already signed in to dCal, open the workspace switcher at the top of the left menu. The workspace you were invited to reads **Invited**. Click it to join it and open it.

### If the page says the invitation is not for you

**This invitation isn’t for this account** means you are signed in with a different address from the one invited. The page shows the address you are signed in with. You have two ways out:

* Click **Sign in with another email** and sign in with the invited address.
* Ask whoever invited you to invite the address you use.

The same page shows when the invitation was removed. **Go to my calendar** takes you to your dashboard.

***

## Work in several workspaces

Joining a workspace does not replace your own: you keep it, and move between them with the workspace switcher.

**Step 1:** Click the workspace name at the top of the left menu, under the wordmark. It shows once you belong to two or more workspaces, counting invitations you have not accepted yet.

**Step 2:** Pick a workspace under **Your workspaces**. The current one has a check mark.

How it works:

* **One workspace at a time.** Every page acts on the workspace you picked. Your browser remembers the choice, in every tab.
* **Signing in starts in your own workspace.** After a fresh sign-in, dCal opens the workspace your Dapta sign-in belongs to. Pick the other one again in the switcher.
* **Your setup is separate in each workspace.** Your name, handle, time zone, schedules, events, connected calendars and bookings in one workspace do not carry over to another.
* **Your role is separate too.** You can be an owner in one workspace and a member in another. The menu follows your role in the workspace you have open: a **Member**, for example, does not see **Connect your agent**, **Tools** or **API and webhooks**.
* **AI agents and API keys.** An AI agent you connect by signing in reaches a workspace you joined only if you are an owner or admin there and have opened it on the web within the last 30 days. An API key works only in the workspace where it was created. See [Connect Claude or ChatGPT by signing in](https://docs.dapta.ai/dcal/developers/connect-with-sign-in.md).
* **Leaving.** To leave a workspace you joined, ask one of its owners or admins to remove you. dCal then takes you back to your own workspace, which stays as it was.

***

## Get a new teammate ready to host

A teammate who joins starts with nothing in your workspace: no calendar and no team. Do these steps in this order.

**Step 1:** Your teammate sets their name. In your workspace, they go to **Settings** > **General** and type a **Display name**. Guests see it on booking pages and in booking emails. See [Your name and time zone](https://docs.dapta.ai/dcal/account/general-settings.md).

**Step 2:** Your teammate connects their own calendar in your workspace. They open **Calendars**, click **Connect a calendar**, and check that **Add new events here** is on for the calendar that should receive bookings. A calendar connected in another workspace does not count here. With it, dCal checks their busy times, and their team bookings on online meetings get a meeting link. See [Connect your calendar](https://docs.dapta.ai/dcal/calendars-and-availability/connect-a-calendar.md).

**Step 3:** An owner or admin adds them to a team: open the team in **Teams**, click **Add member** and type their email. See [Create a team](https://docs.dapta.ai/dcal/teams/create-a-team.md#add-members).

**Step 4:** An owner or admin saves each team event. A team event takes its hosts from the team when you save it, so open each of the team's events and click **Save changes**. Until then, the new teammate is not a host. See [Round-robin, collective and fixed hosts](https://docs.dapta.ai/dcal/teams/scheduling-methods.md).

> **⚠️ Note:** Wait until your teammate has joined before you add them to a team. Until they join and open dCal in your workspace, they have no working hours there, offer no times and are never assigned a round-robin booking. On a **Collective** event, or as a fixed host, that leaves the whole event with no times.

***

## Troubleshooting

| What happens                                      | What to do                                                                                                                                                                                                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| The invitation email did not arrive               | Ask your teammate to look in spam or promotions. Check the address on their row. Wait a minute and click **Resend invite**. If you see the daily limit message, resend it tomorrow.                                                                          |
| **This invitation isn’t for this account**        | Your teammate is signed in with another address. They click **Sign in with another email** and use the invited address. Or **Remove** the old invitation and invite the address they use.                                                                    |
| **Could not join this workspace. Try again.**     | Your teammate clicks **Join workspace** again. If it keeps failing, check in **Settings** > **Members** that their invitation is still there.                                                                                                                |
| Your teammate lands in their own workspace        | That is normal after signing in. They pick your workspace in the switcher at the top of the left menu.                                                                                                                                                       |
| Your teammate offers no times in a team event     | Check that they joined and opened dCal in your workspace, and that each team event was saved after they were added to the team. Then see [Your booking page shows no times](https://docs.dapta.ai/dcal/troubleshooting.md#your-booking-page-shows-no-times). |
| Your teammate's team bookings get no meeting link | They turn on **Add new events here** for one calendar on their **Calendars** page, in your workspace.                                                                                                                                                        |

## Related

* [Members and roles](https://docs.dapta.ai/dcal/account/members-and-roles.md): what each role can do, and how to change or remove someone.
* [Workspaces](https://docs.dapta.ai/dcal/account/workspaces.md): what the workspace shares and what stays personal.
* [Create a team](https://docs.dapta.ai/dcal/teams/create-a-team.md): add teammates to a team.
* [Connect your calendar](https://docs.dapta.ai/dcal/calendars-and-availability/connect-a-calendar.md): so busy times are respected and meeting links are created.
* [Round-robin, collective and fixed hosts](https://docs.dapta.ai/dcal/teams/scheduling-methods.md): how team events pick their hosts.


---

# 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.dapta.ai/dcal/account/invite-teammates.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.
