Create Inquiry

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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.

subject

string | null

The subject 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.

priority

int32 | null

enum

Possible values:

0 = Unknown
10 = Low
20 = Middle
30 = High

Allowed:

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. Note: Will be renamed to AssociatedUserTaskId in future API-Versions.

readStatus

int32 | null

enum

Defaults to 0

Possible values:

0 = Unread
1 = Accepted
2 = Rejected
3 = Open
4 = InProgress
5 = WaitingForAnswer

Allowed:

readByAccountId

int32 | null

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

dueDate

date-time | null

The optional due date of the inquiry.

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