> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hocdoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Team and roles

> Invite members, assign roles, remove members and switch between workspaces.

On the "Team" page you manage your workspace's members. It shows "Members, roles and open invitations of this workspace." Every role sees the list of members. Only owners and admins can invite, manage invitations, change roles and remove. Only they also see the cards "Invite member" and "Open invitations".

## The roles

Each member has exactly one role.

| Role | Short description in the app |
| - | - |
| Owner | "Full access, can manage owners and admins." |
| Admin | "Manages team and settings, cannot change owners." |
| Member | "Creates and sends offers." |
| Viewer | "Can only view offers and analytics." |

Whoever creates a workspace becomes its owner.

### What each role can do

| Area | Viewer | Member | Admin | Owner |
| - | - | - | - | - |
| View offers, templates, library, contacts, analytics | yes | yes | yes | yes |
| Create, edit and send offers | no | yes | yes | yes |
| Generate Deal coach recommendation and email draft, analyze a transcript | no | yes | yes | yes |
| Edit templates, library and contacts | no | yes | yes | yes |
| See the library trash | no | yes | yes | yes |
| Change settings for Workspace, Brand, Sender (including accept button) and Follow-ups | no | no | yes | yes |
| Manage the domain (add, check again, remove) | no | no | yes | yes |
| View domain and status | yes | yes | yes | yes |
| Integrations: see and manage notifications (Slack, Teams) | no | no | yes | yes |
| Integrations: see, create and revoke API keys | no | no | yes | yes |
| Integrations: see and manage webhooks and delivery log | no | no | yes | yes |
| Integrations: view the "Public API" card | yes | yes | yes | yes |
| Countersign an offer (detail page, "Signatures" card) | no | yes | yes | yes |
| Invite members, manage invitations | no | no | yes | yes |
| Change role, remove members | no | no | yes (no owners) | yes |
| Assign the "Owner" role or change an owner | no | no | no | yes |

Each person manages their own account (profile, language, password, two-factor authentication), regardless of role. See [Settings](https://docs.hocdoc.com/en/guides/settings.md).

## Invite a member

The invited person gets "an email with a link that is valid for seven days."

**1. Enter address and role**

In the "Invite member" card, enter the "Email address" and choose the "Role". The choices are Admin, Member and Viewer. Below the field is the description of the chosen role. The default is Member.

**2. Send the invitation**

Choose **Send invitation**. You see "Invitation sent to \[address]." The email comes with the subject "\[Name] invited you to \[Workspace]" and the button "View invitation".

**3. Accept the invitation**

The invited person opens the link and accepts the invitation (see below).

The "Owner" role cannot be assigned by invitation. Invite the person and change their role afterwards (only owners can do that).

### Limits when inviting

* The invitation is valid for seven days. The expiry date is in the email and in the list. The link only works for the invited address.
* If the address is already a member, the app reports "This person is already a member of the workspace."
* You can send at most 50 invitations in 24 hours. A workspace as a whole has this limit too. Resending counts. After that the app reports "You have already sent a lot of invitations today. Please try again tomorrow."
* If you invite the same address again, the earlier open invitation becomes invalid.
* If the email cannot be delivered, the app revokes the invitation immediately and reports it. Then you try again.
* If the inviting person is no longer an owner or admin of the workspace when the invitation is accepted, the invitation counts as withdrawn.

### Open invitations

The "Open invitations" card shows all invitations that have not been accepted yet. For each there are address, role and "Valid until" or "Expired on" with a date. The date follows the workspace's time zone.

| Action | Effect |
| - | - |
| **Resend** | Sends a new email with a new link. The old link becomes invalid. This is also how you reinvite after an invitation has expired. |
| **Revoke** | You confirm in the "Revoke invitation" dialog. The link in the email no longer works afterwards. |

Expired invitations carry the note "Removed 30 days after expiry". An invitation that has already been accepted cannot be revoked. Accepted and revoked invitations no longer appear in the list.

## Accept an invitation

The link in the email opens the page "Invitation to \[Workspace]". It names who invited you with which role, which address the invitation is for and until when.

**1. Sign in with the right address**

Without being signed in, the page currently only offers **Sign in**, with the address prefilled. Below it says: "New accounts are not being created right now. If you already have an account with exactly this email address, sign in." Invited people without an account cannot join at present. You can only accept with an existing account under exactly the invited, confirmed address. More about the account is under [Getting started](https://docs.hocdoc.com/en/guides/getting-started.md).

**2. Accept the invitation**

Choose **Accept invitation**. It is only accepted by click, never automatically when the link is opened.

**3. Work in the workspace**

Afterwards the app opens this workspace's overview.

If your account has two-factor authentication, the app asks for the code first and then takes you back to the invitation.

Some pages appear instead of the acceptance:

| Page | Meaning |
| - | - |
| "Wrong account" | You are signed in with a different address. With **Sign out** you sign out and return to the invitation. |
| "Invitation not found" | The link is invalid or incomplete. |
| "Invitation expired" | The seven days are over. Ask for a new invitation. |
| "Invitation withdrawn" | The invitation was withdrawn. Ask for a new invitation. |
| "Invitation already accepted" | Sign in to open the workspace. |

### Who invited whom

In the member list, below the name and address of an invited member, it says "Invited by …, joined on …" with the name of the person who invited and the day of acceptance. The line stays even if the inviting person has left the workspace. Then their name at the time of acceptance appears there, without an address. If the inviting person has not entered a name in their account, which only still happens with older accounts, it only says "Joined by invitation on …". Whoever created the workspace carries no such line.

## Change a role

In the "Members" table, the "Role" column has a selection for every member you may manage. If you choose a new role, it is saved immediately. You see "The role of \[Name] is now \[Role]."

* Owners can assign any role, including Owner.
* Admins can assign Admin, Member and Viewer. They can neither change nor appoint owners.
* Your own row has neither a selection nor a Remove button. So you cannot change your own role. The column only displays it, and the member is marked "You".
* The last owner cannot be demoted or removed: "The last owner cannot be removed or demoted. Appoint another owner first."

> [!WARNING]
>
> If an owner or admin switches to Member or Viewer, that person's API keys are revoked. A switch between Admin and Owner changes nothing about the keys. There is no confirmation dialog for the revocation. If the person has keys, the note appears in the message after the switch: "The API key of \[Name] was revoked." or for several "The \[number] API keys of \[Name] were revoked." The note follows directly after "The role of \[Name] is now \[Role]." More under [Settings](https://docs.hocdoc.com/en/guides/settings.md) in the "Integrations" section.

## Remove a member

**1. Choose a member**

In the member's row, choose the trash icon ("Remove \[Name]").

**2. Confirm**

The "Remove member" dialog says: "\[Name] (\[address]) immediately loses access to this workspace." Choose **Remove**.

Admins can remove everyone except owners. Owners can remove all other members. Your own row has no Remove button.

> [!WARNING]
>
> If the member has created API keys that have not been revoked yet, the dialog adds: "The API key created by \[Name] will be revoked." For several keys: "The \[number] API keys created by \[Name] will be revoked." The revocation happens with the removal. The list of keys names the reason: "The person who created the key was no longer in this workspace from then on."

## Approval before sending

Approval is available on the Team plan. It ensures that a member only sends an offer after an admin or owner has approved it.

### Set the rule

Owners and admins choose in the settings, in the "Approvals" tab, in the "Approval before sending" card, under "When does a member need approval?":

| Choice | Effect |
| - | - |
| "Never" | No send needs approval. |
| "Always: every send by a member" | Every send by a member needs it. |
| "From a certain offer value" | The send needs it from the amount you enter under "Offer value from" in the workspace's currency. |

For the offer value, the preselected package including preselected add-ons counts. Offers in a currency other than the workspace's always need approval. The rule applies to members. Owners and admins never need approval, and viewers do not send.

### One or two approvals

Under "How many approvals does a send need?", owners and admins choose:

| Choice | Effect |
| - | - |
| "One: an admin or owner" | One approval is enough. This is the default. |
| "Two: two different admins or owners" | A request only counts as approved once two different admins or owners have agreed. |

The number applies to each of the three rules above. In addition:

* The person who requests never counts, not even if they later become an admin. Each person agrees at most once.
* Two approvals are only possible once the workspace has at least two admins or owners. Otherwise the card warns: "Two approvals are only possible once the workspace has at least two admins or owners."
* If an admin or owner declines, the request is rejected. A revocation revokes the whole approval. If someone changes the draft, it expires as before.
* If you change the number, the higher number applies to open requests. Switching from two to one makes an open request with one approval unsendable. Approvals already granted stay granted.
* Whoever is no longer an admin or owner no longer counts. If this makes a granted approval incomplete when two agreements are needed, it is revoked, without an email. The member requests again.
* If the number of admins falls below two, nobody can complete requests that need two approvals. A remaining admin rejects them and switches to one approval. HocDoc never lowers the number on its own.

### Request approval

If a send needs approval, the send dialog shows **Request approval**. You can add a message to the approvers ("Message to the approvers (optional)"). The approval applies to exactly these details: recipient, company, valid until and the offer as it is sent. Admins and owners get an email with the subject "Approval requested: \[Title]". While the request is open, the dialog says: "Your request is open. You will get an email once an admin or owner has decided."

### Approve or reject

Owners and admins see open requests in the settings under "Open requests" and on the offer in the "Approval" card. There they choose **Approve** or **Reject**. A comment is optional, but required for a rejection. Whoever requested gets an email ("Approved: \[Title]" or "Rejected: \[Title]") with the comment.

* With two approvals, the "Approval" card and the "Open requests" list show the state, for example "1 of 2 approvals", with the names of those who agreed. Whoever has already agreed or requested sees a note instead of the buttons. After the first agreement, the other admins and owners get the email "One more approval needed", the send dialog shows "1 of 2 approvals so far." and the email to the requesting person names both names.
* After approval, the dialog says: "Approved. You can send it now." Recipient, company and Valid until are then fixed.
* After a rejection you change the offer and request again, or you ask once more with the same version.
* An approval applies to exactly one version of the draft. If someone changes something afterwards, the card says "The draft has changed since the request." and the send needs a new request.

The offer's history shows request, approval, rejection and revocation. With two approvals, each individual agreement appears as its own entry. If an admin changes the number, it appears in the [audit log](https://docs.hocdoc.com/en/guides/settings.md#audit-log).

### Reminder

If a request is still open after 24 hours, an email ("Reminder: approval for \[Title] is open") reminds the admins and owners once, with two approvals only those who have not yet decided, in the language of their account. There is no second reminder. Per workspace at most 10 reminders go out per run and 20 per day.

### Revoke approval

Owners and admins revoke an approval up to the send. On the "Approval" card they choose **Revoke approval** and enter a reason under "Reason for revoking". It is required, and the person who requested gets it by email ("Approval revoked: \[Title]"). The card shows "Approval revoked by \[Name]." with the reason. After that, the send needs a new approval: the member adjusts the offer or asks once more with the same version. After the send, the approval can no longer be revoked ("The offer was already sent with this approval. It can no longer be revoked.").

### Locked sections

Admins and owners lock individual sections in the builder (**Lock section**, on the right in the "Lock" field). Only admins and owners change, move and delete locked sections. Members see a lock and the note "Locked, only admins can change it". The lock also stays in offers created from a template with this section. More under [Templates and variables](https://docs.hocdoc.com/en/guides/templates-and-variables.md#locked-sections). Locked sections are available on the Team plan.

An offer created from a template keeps the template's locks in any case, even if it is created through the API. Members do not create a template with locked sections, neither with "Save as template" nor through the Data API: locking is reserved for admins and owners.

## Switch between workspaces

You can be a member of several workspaces, for example through invitations. From two workspaces on, the account menu at the bottom left shows the "Switch workspace" section. The active workspace carries a checkmark. If you choose another, the app opens its overview.

The app remembers your choice. Roles apply per workspace: you can be an owner in one workspace and a viewer in another.

## Read-only mode for viewers

Viewers see offers and analytics but change nothing.

* In the builder, "Read only" appears at the top with a note: "You have read access in this workspace. You can view the offer, but not change it." The sidebar shows only the offer's structure. There is no save status, no undo and no sending. Sections can be viewed and selected.
* On an offer's detail page the button is called **View in the builder** instead of "Open in the builder".
* On the "New offer" page it says: "You only have read access in this workspace and cannot create offers." The offer list shows no "New offer" button. Templates, library and contacts cannot be edited, and the library trash is missing.
* In the settings, "Read only." appears.
* In onboarding, "Create your first offer" is missing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.