> ## Documentation Index > Fetch the complete documentation index at: https://api.housera.ro/llms.txt > Use this file to discover all available pages before exploring further. # Tell the people who saved the listing > Tells the people who saved the listing about your open house, once per window, like the button on the portal. Each of them gets a notification in their account, and the email goes only to those who kept viewing emails on. People who manage the listing, people who can't receive messages from you are left out. A second request for the same window sends nothing and answers `already_announced: true`. A window that has ended is not announced. You can send at most 10 requests a minute. ## OpenAPI ````yaml en/openapi.json POST /viewings/{slot}/open-house/announce openapi: 3.1.2 info: title: Housera API version: 1.0.0 description: >- Publish and manage real estate listings on Housera from your CRM or your own application, under the same rules as the form on the Housera portal. servers: - url: https://staging.housera.ro/api/v1 description: 'Sandbox (staging): test data, same rules as production.' - url: https://housera.ro/api/v1 description: 'Production: the real listings on housera.ro.' security: - bearer: [] tags: - name: Your listings - name: Photos - name: Events - name: Vocabulary - name: Connect with Housera - name: Client requests - name: The company and its team - name: Marketing mandates - name: Viewings - name: Projects - name: Partnerships - name: API key - name: Statistics paths: /viewings/{slot}/open-house/announce: post: tags: - Viewings summary: Tell the people who saved the listing description: >- Tells the people who saved the listing about your open house, once per window, like the button on the portal. Each of them gets a notification in their account, and the email goes only to those who kept viewing emails on. People who manage the listing, people who can't receive messages from you are left out. A second request for the same window sends nothing and answers `already_announced: true`. A window that has ended is not announced. You can send at most 10 requests a minute. operationId: v1.open_house.announce parameters: - name: slot in: path required: true schema: type: integer description: The id of the time or window, from the agenda's `slots[].id`. - name: locale in: query required: false schema: type: string enum: - ro - en default: en example: en description: >- The response language, `ro` or `en`. It changes error messages (`title`, `detail`), labels and, when the listing has an approved translation in that language, its title and description. Codes are the same in every language. It takes precedence over `Accept-Language` and over the account's language. responses: '200': content: application/json: schema: type: object properties: data: type: object properties: told: type: integer const: 0 description: How many people were told just now. already_announced: type: boolean description: >- `true` when the window had already been announced, by you or a colleague. required: - told - already_announced description: The result of the request. required: - data description: '`told` is how many people were told.' '401': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: The key is missing, revoked or expired (`unauthenticated`). '403': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- The key lacks the required permission (`missing_ability`) or access is denied (`forbidden`). '404': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- The listing does not exist or the key has no access to it (`not_found`). '429': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Too many requests. Try again after the number of seconds in `Retry-After`. '503': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Housera has temporarily paused writes through the API (`api_writes_paused`). Try again after the number of seconds in `Retry-After`. components: schemas: Problem: type: object title: Problem properties: type: type: string format: uri description: The URL of the problem type (RFC 9457). title: type: string description: A short summary of the problem, in the request's language. status: type: integer description: The HTTP status code. code: type: string description: >- The stable code of the refusal, the one to handle the error by (the list is on the Errors page). detail: type: string description: The explanation, in the request's language. existing: type: object properties: code: type: string description: The existing listing's public code. external_ref: type: - string - 'null' description: >- Your ID for the existing listing, if you set it with `PUT /listings/ref/{ref}`. Otherwise `null`. required: - code - external_ref description: >- Only on `409 duplicate_listing`: the listing you already have for the same property. required: - type - title - status - code - detail securitySchemes: bearer: type: http scheme: bearer description: 'Authorization: Bearer ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.