Troubleshooting the most common problems
Sign-in, enquiries, replies, listings, MCP and features missing from your plan: the cause and the next step for each problem.
Last updated:
Find the problem you see. Each one has a cause and a next step.
Sign-in
The sign-in code does not arrive or is rejected
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
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
My enquiry to a provider does not go out
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). |
| 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
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
My listing does not go online
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.
My listing does not appear in ChatGPT and Claude
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, or ask the assistant to publish the listing again.
Plan and API
A feature is missing in my 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
Branch on the code, never on the text. The REST API returns it as code in a problem (Errors, API error codes), the routes of the app as { "error": "<code>" }; their meaning is under Error codes. On 429, wait as long as Retry-After says (REST API limits, MCP limits).
Keep reading
Fixing problems with the MCP connection
What an error means when you connect to or call Athaus für Anbieter and Athaus Immobiliensuche, and what to do about it.
Error codes of the app and the MCP servers: what each code means
Every code the app and the MCP servers return, with its meaning. Generated from the registry they are typed against.
How to publish a listing
From draft to a live listing in the athaus.ai catalog, with the list of required details and the route into ChatGPT and Claude.
The path of an enquiry and its reply
An enquiry only goes out after your yes, and the reply arrives in the app and as a copy by email. How it works, including the Athaus reply address.