/api/inquiries

post

https://api.facilioo.de/api/inquiries

Create Inquiry

Creates a new inquiry from the provided data, associating it within the requester's scope.

Module: Inquiries

Returns: Inquiries → Inquiries → InquiryRead (single)

Authorization

Required Token Scopes: Platform (0)

Allowed Party Types (Account Role): Admin (1), Property Management Company (2), User (7)

Required Permissions: Create (0)

This will be evaluated against your used access token.

Body Params

sourceId

int32

required

The ID of the source of the inquiry (InquirySource).

categoryId

int32 | null

The ID of the category of the inquiry.

report

string

required

The main report or description of the inquiry.

rejectionResponse

string | null

The response provided when the inquiry is rejected.

completionResponse

string | null

The response provided when the inquiry is completed.

connectedPartyId

int32

required

The ID of the party connected to the inquiry. Reporter of the inquiry, e.g. tenant/owner/contractor.

receiverPartyId

int32

required

The ID of the party that receives the inquiry. Usually the PropertyManager.

connectedPropertyId

int32 | null

The ID of the property connected to the inquiry.

connectedUnitId

int32 | null

The ID of the unit connected to the inquiry, has to be a unit of the given connected property.

associatedProcessId

int32 | null

The ID of the process associated with the inquiry.

associatedTodoId

int32 | null

The ID of the UserTask associated with the inquiry.

readStatus

int32 | null

Defaults to 0

The read status of the inquiry (0 for unread, 1 for accepted, 2 for rejected).

readByAccountId

int32 | null

The ID of the account that read the inquiry and marked the inquiry as accepted/rejected.

Headers

Accept-Language

string

Language preference header. Allowed languages: German (en-DE).

api-version

string

Defaults to 2.0

API version to use (1 or 2) either with trailing .0 or without. Defaults to 2.0, if omitted. Can be prefilled based on the currently selected API Definition (Swagger UI).

Responses

401

Error: Unauthorized

200OK

400Bad Request

404Not Found