Who can do what
Members and viewers see the note “Read only. Only admins and owners can change these settings.” in all tabs except “Account”: Workspace, Brand, Sender, Domain, Follow-ups and Integrations. In the first three tabs the fields are then locked and there is no Save button. In the “Integrations” tab the cards “Notifications”, “API keys”, “Webhooks” and “Delivery log” are missing for them. More about roles is under Team and roles.
Workspace
Here you maintain your workspace’s name, slug, time zone and currency. Below are two cards: “Accepted out of 10 offers before HocDoc” and “Language of new offers”. With Save you apply the changes.What the time zone does
The time zone determines “the days in charts and key figures as well as the dates and deadlines shown”. This affects, for example, the overview, the analytics and your offers’ deadlines. Emails also state dates in the workspace’s time zone. The public offer page shows deadlines in the sending workspace’s time zone, so they read the same for sender and recipient.What the currency does
The workspace’s currency is the default for the price when you create a new service in the Library. You can change it there per entry. Nothing is converted.Accepted out of 10 offers before HocDoc
The card “Accepted out of 10 offers before HocDoc” asks: “Optional: How many out of 10 offers were accepted at your company before you started using HocDoc?” In the “Accepted out of 10 offers” field you choose a number from 0 to 10 or “Not stated”. With Apply you save. The card names the date of the entry (“Entered on …”). Owners and admins change the figure. All other roles see the value locked. HocDoc uses the figure as a comparison value on the Analytics page: the card “Comparison with the figure before HocDoc” sets it against the actual close rate (see Analytics).Brand
Brand applies to the public offer page your recipients see and to the canvas and preview in the builder, not to the rest of the app. Next to the form you see a “Preview” with your settings.Logo
With Upload logo you choose a file, with Replace logo you swap it, with Remove logo you take the logo away again. It is only saved with Save.- PNG, JPEG and WebP are allowed, up to 2 MB.
- Landscape format with an aspect ratio between 1:1 and 5:1 works best.
- The logo appears in the header of the offer page. Without a logo, the header shows the HocDoc logo and, except on narrow screens, the workspace’s name.
Primary color
You choose the color with the “Color picker”, via the “Color suggestions” or as a “Hex value” with six characters, for example 0247EF. With Use default you return to the default color. Without input, the default color stays active.Font
You choose one of five fonts: Geist (default), Inter, DM Sans, Source Serif 4 or Playfair Display.Logo, color and font always apply in their current state. Changes therefore also affect offers you have already sent. The offer PDF shows neither logo nor primary color.
Sender
The “Sender” tab determines what appears in emails to recipients and in the footer of the public offer page. The “Preview” next to the form shows how “From” and “Reply to” look in the email and what the footer will be. Without entries no footer appears.
All fields are optional. Links must begin with
https://. The footer appears in the emails to recipients and on the public offer page.
The sender details are recorded on the offer when sending. Changes therefore apply to offers you send afterwards. Offers already sent keep the state from the send.
Accept button card
Below the sender form, before the “After acceptance” card, is the “Accept button” card with its own Save. It sets the text of the button with which the recipient completes the acceptance. It applies to every new send. Sent offers keep their state.- Whitespace at the edges is removed.
- Double curly braces are not allowed, and placeholders are not resolved here. The message reads: “The accept button text can’t contain double curly braces.”
- Line breaks, control characters, invisible characters and a text without any visible character are not allowed. The message reads: “The accept button text contains characters that aren’t allowed.”
- The field accepts at most 40 characters, and more cannot be entered.
- If saving fails, it says: “The accept button text couldn’t be saved.”
- Owners and admins can change and save. Members and viewers see the field locked and without a Save button.
After acceptance card
Below the sender form is a card of its own with its own Save. It sets the default for the step that follows acceptance, for example a link to book an appointment.- Without a link no button appears. A text alone is not saved, and the field points this out.
- The card is a default for new offers. In the send dialog you can change link and text per offer.
- Sent offers keep their state.
- The button only appears after acceptance and opens the link in a new tab.
Onboarding form after acceptance card
Below the “After acceptance” card is the “Onboarding form after acceptance” card. It collects questions the recipient answers after acceptance. Owners and admins can manage it.- Add question creates a question. The question text has at most 200 characters and sits on one line. There are at most 10 questions (“At most 10 questions.”).
- Move up and Move down sort the questions. Remove question deletes a question.
- Under Answer type you choose “Short text”, “Long text” or “File upload”. For a file question, the field Note for the recipient (optional) is added. More under Files after acceptance.
- Required makes the answer mandatory.
- Under “Suggestions to add” are “Billing address”, “Contact person for the project” and “Preferred start date”. An added suggestion is a question like any other.
- Without questions there is no form (“No questions yet. Without questions there is no form.”).
Domain
In the “Domain” tab you enter a custom domain, a subdomain such asangebote.deine-firma.de or the root domain, so that offer links sit under your address instead of app.hocdoc.com. The “Custom domain” card shows domain, status, the DNS records, Check again and Remove. Members and viewers see domain and status without buttons. The full guide is under Custom domain. A second card, “Sender domain for emails”, makes sure emails to recipients and signers come from an address on your domain. It is in the same section of the guide: Sender domain for emails.
If the root domain has a www variant, you choose it on the “Custom domain” card, and the DNS list names the TXT record for proof of ownership. Both are in the guide: www variant and Proof of ownership.
Follow-ups
In the “Follow-ups” tab you switch on automatic follow-ups. The card is called “Follow up automatically”. You switch on each of the four rules (“Not opened”, “Opened but not accepted”, “Expiring soon”, “Signature pending”) individually and set the days (a whole number from 1 to 30). Without a setting, everything is off. The guide is under Automatic follow-ups.Integrations
In the “Integrations” tab you set up notifications to Slack and Microsoft Teams and create API keys and webhooks. With a key, your own systems read this workspace’s offers and their timeline. With a webhook, HocDoc tells your system when something happens to an offer. The tab has six cards: Connections, Notifications, API keys, Webhooks, Delivery log and Public API. The Notifications and Connections cards are described in the guide Notifications and connections. Webhooks have a section of their own under Webhooks. The description of the interface itself is in the API documentation, authentication under Authentication.Who can do it
Owners and admins see the “API keys” card and manage the keys. Members and viewers see the note “Read only.”, the “Connections” card (with the note “Admins and owners can connect and disconnect.”) and the “Public API” card, but no keys. If the list cannot be loaded, it says “Loading failed.” with “API keys couldn’t be loaded. Please reload the page.” If you lack the right when creating or revoking, for example after a role change with the page open, it says: “Only admins and owners can manage API keys.”What a key can do
“Access for your own systems.” The dialog says: “The key reads the offers of this workspace. With write permission it can also create offers from templates, send and withdraw them.” When creating, you choose the Permission: Read only or Read and write. With write permission, the key acts in your name: offers count as yours, and your role and the approval rules apply. More in the API introduction.Create a key
1
Open the dialog
In the “API keys” card, choose Create API key. The dialog is called “Create API key”.
2
Name and expiry date
Name is required (at most 80 characters, no control characters). It should say what the key is for, for example the name of the system. Under Valid until (optional) you choose a date. Without a date, the key is valid until it is revoked. Choose Create.
3
Copy the key
The “API key created” dialog shows the whole key in the API key field. With Copy you put it on the clipboard. The dialog says: “This key is only shown now. Keep it in a safe place.” It only closes with Done, and a click next to it does not close it. Afterwards the key can no longer be displayed.
Expiry date
- The date is optional.
- The key is valid until the end of the chosen day in the workspace’s time zone.
- Selectable is today at the earliest and a date just under ten years ahead at the latest. Otherwise it says: “The expiry date must be in the future, at most 10 years ahead.”
- Name and expiry date cannot be changed after creating. If you need other values, you revoke the key and create a new one.
List
The list shows each key with its name and a status: Active, Expired or Revoked. Below are:- the first 20 characters of the key, followed by an ellipsis. The app never shows the rest again.
- “Created on” with the date and “by” with the name of the person who created it,
- “Last used on” with date and time or “Not used yet”,
- with an expiry date set, “Valid until” with the date, after expiry “Expired on”,
- for a revoked key “Revoked on” with the date.
Limit
A workspace has at most 10 keys that are not revoked. Expired keys count until you revoke them. The card’s description names the state (“3 of 10 in use.”). Once the limit is reached, Create API key is locked, and the card says: “The limit has been reached. Revoke a key to create a new one.” There is also a limit for new keys: if too many are created in 24 hours, it says: “Too many API keys were created in the last 24 hours. Please try again later.”Revoke a key
On a key, choose Revoke and confirm in the “API key revoked” dialog. The dialog says: “The key “[Name]” stops working immediately. This cannot be undone.” Afterwards it says “API key “[Name]” revoked.” The key stays in the list with the status “Revoked”. The list shows all keys that are not revoked, plus the ten most recently revoked.Automatic revocation
A key ends with the admin role of the person who created it. If this person is removed from the workspace or is afterwards neither admin nor owner, all their keys are revoked. The list names the reason:- “Revoked automatically on” followed by a date: “The person who created the key was no longer in this workspace from then on.”
- “Revoked automatically on” followed by a date: “The person who created the key was no longer an admin from then on.”
Webhooks
With a webhook, HocDoc calls an address of your system as soon as something happens to an offer. You do not have to poll. The “Webhooks” card says: “Send events to your own systems.” Its description names the state (“2 of 5 endpoints added.”). As long as there is no endpoint, it says: “No endpoint yet”. Only owners and admins see and manage webhooks. If you lack the right, for example after a role change with the page open, it says: “Only admins and owners can manage webhooks.” If the card cannot be loaded, it says “Loading failed.” with “Webhooks could not be loaded. Please reload the page.” The technical side is in the API documentation on webhooks: structure of the calls, verifying the signature, retries and limits.Add an endpoint
1
Open the dialog
In the “Webhooks” card, choose Add endpoint. The dialog says: “Every selected event is sent to this address as a signed call.”
2
Address and events
Under URL, enter your system’s address. Only https applies, for example https://example.com/webhooks. Under Description (optional) you say what the endpoint is for, for example the name of the system. Under Events you choose what the endpoint should receive. It only receives what is chosen there. Choose Add.
3
Copy the secret
The “Endpoint added” dialog shows the secret in the Secret field. With Copy you put it on the clipboard. The dialog says: “This secret is only shown now. Keep it safe.” Your system uses it to check that a call really comes from HocDoc. Close the dialog with Done.
A new endpoint starts with all events of this list selected. “Domain status changed” is not preselected, and you choose it yourself.
Rules for the address:
- Only https, without credentials and without @. Only the standard port 443 is allowed.
- The address needs a public name, for example example.com. An IP address is not allowed.
- Addresses on hocdoc.com, vercel.app and supabase.co are not allowed, nor is your workspace’s own domain for offer pages. Then it says: “This address is not allowed.”
- HocDoc does not follow redirects. If your system answers with a redirect, it counts as failed.
List
The list shows each endpoint with its address and a status: Active, Paused or Paused automatically. Below are “Last success on” with date and time or “Nothing delivered yet”, for a failure “Last failure on” and “Added on” with the date and the person who added it. Times are in the workspace’s time zone.Send a test
With Send test, HocDoc sends a test event (“Test”) to the endpoint. This way you check the address and the signature verification without needing an offer. Afterwards it says “Test sent. The result is in the delivery log.” If you send too many tests in a short time, it says: “Too many tests in a short time. Please try again in a few minutes.” 10 tests in 10 minutes are allowed.Edit
With Edit you change address, description and events. The dialog says: “The secret stays as it is.” With Save you apply the change.Pause and resume
With Pause you stop an endpoint. Open deliveries are cancelled, and it says: “Endpoint paused. Open deliveries were cancelled.” The list says: “Paused on” with a date, “No events go to this address in the meantime.” With Resume the endpoint runs again.Automatic pause
If several deliveries to an endpoint finally fail in a row (5 in a row), HocDoc pauses it on its own. The list then shows “Paused automatically” and says: “Paused automatically on” with a date and the number of failed deliveries in a row. Check the receiver and then choose Resume.Regenerate the secret
If you have lost the secret, you choose Regenerate secret and confirm with Regenerate. The dialog says: “The current secret stops working immediately. Your receiver needs the new secret, otherwise it will reject the calls. We retry rejected messages automatically until you have entered the new secret there.” The old and the new secret never work at the same time. Afterwards the “New secret” dialog shows the new secret once, as when adding. Enter it in your system.Delete an endpoint
Choose Delete and confirm in the “Delete endpoint” dialog. The dialog says: “[Address] will no longer receive any events. This endpoint’s delivery log is deleted too. This cannot be undone.”Delivery log
The “Delivery log” card shows what went to your endpoints and to your channels for notifications: “The last 50 deliveries. Entries are deleted after 30 days.” With Refresh you reload the list. As long as nothing has been delivered, it says: “No delivery yet”. Each entry names the event, the address (“on” with the address’s name), date and time, the status and the number of attempts. For a response it also shows “Status” with the code and the duration in milliseconds. The status is one of:
An attempt counts as failed if your system does not answer with a success code within 10 seconds. HocDoc tries up to 8 times in about a day.
Typical reasons the entry names:
- “No response within 10 seconds.”
- “The receiver responded with an error.”
- “The encrypted connection could not be established. Check the certificate of the receiver.”
- “The receiver redirected. Redirects are not followed.”
- “Cancelled because the endpoint was paused.”
- “Not queued because too many deliveries were already open for this endpoint.”
Send again
For a failed delivery you choose Send again. Afterwards it says: “The delivery is being sent again.” The call has the same content and the same ID as before. A delivery can be sent again up to 5 times. If the endpoint is paused, you resume it first. Otherwise it says: “The endpoint is paused. Resume it first.” If the endpoint already has 1000 open deliveries, Send again is rejected. Then it says: “This endpoint already has 1000 deliveries waiting. Please try again later.”Public API card
All roles see this card. It says: “Read offers and their timeline. With write permission, also create, send and withdraw offers. Every request needs an API key.” It shows:Language of new offers
The “Language of new offers” card sets which language new offers start in: Deutsch or English. Under Language you choose the language and save with Set language. Owners and admins change the default, all others see the value locked. The default only applies to new offers. Below the selection is the note “This only applies to offers. You set the app’s own language under Account.” with a link to the “Account” tab. For a draft, the language changes in the builder. Everything about it is under Language per offer.Approvals
The “Approvals” tab is part of the Team plan. On other plans it shows the note “Approvals are part of the Team plan”, and a saved rule only applies again once the workspace is on the Team plan. The “Approval before sending” card sets when a member may only send an offer after an approval. Owners and admins change the rule, all other roles see it locked. There they also set how many approvals a send needs: one or two. Below is the “Open requests” list. How approvals work is described under Approval before sending.Audit log
The “Audit log” tab shows who changed what and when in the team and in the settings. Only owners and admins see it, and it belongs to the Team plan. On other plans it says “The audit log is part of the Team plan”: entries already arise now and appear with the Team plan. Entries are kept for 365 days. The audit log records:- Team: member added, role changed, owner role changed, member removed, workspace left. Invitations sent, withdrawn and accepted (the invitation’s address is shortened, such as
m…@example.com). - Approvals: approval rule changed, approval granted, rejected and revoked (without a comment), sections locked in templates and lock removed.
- Domains: domain and sender domain added, active and removed.
- API: API key created (with permission) and revoked, webhooks added, changed, paused, resumed, deleted and secret renewed.
- Integrations: Slack and Microsoft Teams connected, changed, paused, resumed and disconnected, CRM connections connected and disconnected.
- Settings: workspace renamed, plan, language, time zone, currency and baseline changed, brand, sender details and follow-up rules changed.
Account
The “Account” tab only concerns your own account and is open to all roles.Profile
In the “Display name” field you set how you appear in the team and in the app (2 to 120 characters). The app displays the email address. It cannot be changed there.Interface language
The “Language” card sits between Profile and Password. Under Interface language you choose “Deutsch” or “English” and save with Save.- The choice belongs to your account. It applies in every browser and on every device as soon as you sign in: after signing in, the app takes over your account’s language. It stays after signing out. A cookie of this browser additionally remembers it.
- On the sign-in pages the same choice appears small in the footer. If you are signed in there, it saves the language in the account.
- If you have never chosen, HocDoc suggests your browser’s language if it is German or English. Otherwise German applies. The suggestion sets nothing, and your choice takes precedence.
- The emails to you as the sender (first open, acceptance, answers in the onboarding form, countersignature pending) arrive in your account’s language. Without a choice they are in German.
- The team invitation email arrives in the language of the person who invites. The page on which the invited person accepts the invitation follows the language they chose there, otherwise their browser.
€1,500.00). In money fields, the comma then counts as the thousands separator and the period as the decimal separator.
What does not depend on the interface: Everything the recipient of an offer sees depends on the offer’s language: the offer page, the emails to recipients and signers, the offer PDF and the certificate. The messages to Slack and Teams stay in German.
The labels in this documentation are the English ones.
Change password
You enter “Current password”, “New password” (at least 6 characters) and “Repeat new password” and choose Change password. The new password must differ from the current one. If your account has two-factor authentication, the field “Code from the authenticator app” is added. If you have forgotten your password, use “Forgot password?” on the sign-in page.Two-factor authentication
With two-factor authentication, the app asks at sign-in for a code from an authenticator app on your phone in addition to the password. The card shows “Active” or “Not active”. Set up1
Choose Set up
Choose Set up. The card shows a QR code and a key to type in.
2
Scan the QR code
Scan the QR code with an authenticator app (for example Google Authenticator, 1Password or Authy). If that does not work, type the key into the app. It is only shown now.
3
Enter the code
Enter the 6-digit code from the app in “Code from the authenticator app” and choose Activate. With Cancel you abort the setup.
- When they are created: Right after you activate two-factor authentication, the app creates ten codes. Each code has 16 characters and is shown in groups of four.
- One-time display: The “Your recovery codes” section shows the codes only now. The app stores only a check value, not the codes themselves. Each code works once. Keep the codes separate from your phone.
- Copy: Copy puts all codes on the clipboard.
- Text file: Download as text file saves the file
hocdoc-wiederherstellungscodes.txt. It is created in your browser and contains the codes, your account’s address, the date and a short note on use. - Finish: With I have saved the codes you close the display. Afterwards the same codes cannot be shown again.
- State: The “Two-factor authentication” card has the “Recovery codes” section. It shows how many codes are left, for example “7 of 10 left.”
- Generate new codes: With Generate new codes you replace all codes with ten new ones. The app asks once beforehand: “The previous codes will stop working.” Confirm with Generate new codes or choose Cancel. Afterwards the card shows the new codes once, as after activating. An email “New recovery codes created” goes to your account’s address, in your account’s language. It never contains a code.
- Accounts with two-factor authentication from before: If your account has had two-factor authentication for a while, there are no codes yet. The section then says: “This account has no recovery codes. Generate some so you can get into your account even without your phone.” With Generate codes you create them, without a confirmation.
1
Choose a recovery code
On the “Two-factor confirmation” page, choose the link “Use a recovery code”. The page is then called the same.
2
Enter the code
Enter one of your codes in the Recovery code field and choose Redeem code. Upper and lower case, spaces and hyphens do not matter. With “Enter the code from the authenticator app” you return to the normal prompt.
3
Sign in again
The app removes two-factor authentication, signs out all devices and takes you to the sign-in. There it says: “Two-factor authentication has been removed and all devices have been signed out. Sign in again and set it up again in your account settings.”
- The redeemed code is used up, and the remaining codes expire with the two-factor authentication. The password is enough to sign in again.
- An email with the subject “Recovery code used for HocDoc” and the button “Reset password” goes to your account’s address. It never contains a code.
- If you set up two-factor authentication again, you get new codes.
- Rarely, another factor of your account cannot be removed safely. Then the sign-in says in red: “The recovery code was redeemed and all devices have been signed out. Another factor on your account could not be removed reliably. If sign-in still asks for a code, write to support@hocdoc.com.”
Lockout after failed attempts
After 5 wrong codes within 15 minutes, the app locks redeeming for 15 minutes. During the lockout it also rejects a correct code. The lockout counts separately from the code from the authenticator app: the normal code keeps working in the meantime.