# Troubleshooting the most common problems

Adresse: https://docs.athaus.ai/en/hilfe/fehlerbehebung

> Sign-in, enquiries, replies, listings, MCP and features missing from your plan: the cause and the next step for each problem.

Type: Guide
Last updated: 2026-11-10

Find the problem you see. Each one has a cause and a next step.

## Sign-in [#sign-in]

### The sign-in code does not arrive or is rejected [#anmeldung]

**Cause:** Athaus sends at most one code or link per address per minute. A code is valid for 5 minutes and stops working after 3 wrong entries. No mail reaches a throwaway address (`wegwerf_adresse`) or a domain that accepts no mail (`adresse_unzustellbar`). If the address has a password, Athaus does not send a code (`passwort_anmeldung`).

**Fix:** Wait a minute, have a new code sent and enter the one from the newest mail. Check spam and the spelling. If your account has a password, sign in with it.

### The two-factor code is not accepted [#zwei-faktor]

**Cause:** Neither the code from your authenticator app nor an unused backup code fits (`zweiter_faktor_code_falsch`). After too many wrong codes, the account accepts no more for a quarter of an hour (`zweiter_faktor_gesperrt`).

## Enquiries and replies [#enquiries-and-replies]

### My enquiry to a provider does not go out [#anfrage-sendet-nicht]

**Cause:** An enquiry goes out with your click. After that it can fail for these reasons:

| Reason                                                                                         | What you do                                                                  |
| ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Too many enquiries from you, to this address or to this listing in a short time (`zu_haeufig`) | Try again in a few hours ([Limits](/en/mcp/grenzen#anfragen-an-anbieter)).   |
| The listing is no longer running or is not visible to assistants                               | Search for the listing again.                                                |
| A throwaway address or an undeliverable domain in the account                                  | Change the email address in your account.                                    |
| No plan for enquiries, or the enquiries of the period are used up                              | Under Billing you can change the plan and see when enquiries are free again. |

### The provider's reply is missing [#antwort-fehlt]

**Cause:** For a listing from one of our partners, every enquiry has its own Athaus reply address. The reply appears in your enquiries, and you get a copy by email. It does not arrive if:

* it is an **automatic reply** or a bounce (out-of-office note, system mail), which Athaus sets aside,
* the **loop brake** applies: at most 10 mails per enquiry per hour and 40 per day,

## Listings [#listings]

### My listing does not go online [#inserat]

**Cause:** The listing needs all mandatory details and a photo. If something is missing, Athaus names it (`unvollstaendig`). Four more reasons need a decision or are ones you do not fix yourself:

| Code                    | Meaning                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| `inserat_reserviert`    | The property is reserved. Lift the reservation.                                                               |
| `inserat_abgeschlossen` | Sold or let, does not go online again.                                                                        |
| `inserat_gesperrt`      | Athaus has blocked the listing. You cannot lift that yourself.                                                |
| `plan_required`         | The plan of your office does not include the provider side, or no longer does. Change the plan under Billing. |

**Fix:** Add what is missing: [How to publish a listing](/en/anleitungen/inserat-veroeffentlichen).

### My listing does not appear in ChatGPT and Claude [#assistenten]

**Cause:** A running listing can be found there without further action. It is missing if it is not running, if a commercial provider has not entered an imprint (`impressum_fehlt`), or if it was taken out through an assistant with `unpublish_listing`.

**Fix:** Enter the imprint under [Settings, Office](https://app.athaus.ai/einstellungen/buero), or ask the assistant to publish the listing again.

## Plan and API [#plan-and-api]

### A feature is missing in my plan [#plan]

**Cause:** Basic applies per account and holds up to three properties. New Basic contracts do not include CRM connections, stock import, automations, projects, connections to assistants, API keys or the owner report. The response is `plan_required`, for a key `tarif_zu_klein`. Older contracts keep their scope.

### A program gets an error code [#api]

Branch on the code, never on the text. The REST API returns it as `code` in a problem ([Errors](/en/api/v1/fehler), [API error codes](/en/api/errors)), the routes of the app as `{ "error": "<code>" }`; their meaning is under [Error codes](/en/api/fehlercodes). On `429`, wait as long as `Retry-After` says ([REST API limits](/en/api/v1/limits), [MCP limits](/en/mcp/grenzen)).
