From 7fdc0cd79f638714c5cbc2bb934986cc50474e20 Mon Sep 17 00:00:00 2001 From: johncroker Date: Mon, 14 Sep 2026 15:59:02 +0100 Subject: [PATCH 1/7] add enquiry endpoint --- src/Models/EnquiryCreation.php | 292 +++++++++++++++++++++++++++++++++ src/Models/EnquirySaved.php | 36 ++++ src/Requests/PostEnquiry.php | 52 ++++++ swagger/api-channel.yml | 100 +++++++++++ swagger/api.yml | 90 ++++++++++ 5 files changed, 570 insertions(+) create mode 100644 src/Models/EnquiryCreation.php create mode 100644 src/Models/EnquirySaved.php create mode 100644 src/Requests/PostEnquiry.php diff --git a/src/Models/EnquiryCreation.php b/src/Models/EnquiryCreation.php new file mode 100644 index 0000000..bb31103 --- /dev/null +++ b/src/Models/EnquiryCreation.php @@ -0,0 +1,292 @@ +property_id; + } + + + /** + * @param int $property_id + * + * @return $this + */ + public function setPropertyId($property_id) + { + $this->property_id = $property_id; + + return $this; + } + + + /** + * @return string + */ + public function getContractId() + { + return $this->contract_id; + } + + + /** + * @param string $contract_id + * + * @return $this + */ + public function setContractId($contract_id) + { + $this->contract_id = $contract_id; + + return $this; + } + + + /** + * @return string + */ + public function getFirstName() + { + return $this->first_name; + } + + + /** + * @param string $first_name + * + * @return $this + */ + public function setFirstName($first_name) + { + $this->first_name = $first_name; + + return $this; + } + + + /** + * @return string + */ + public function getLastName() + { + return $this->last_name; + } + + + /** + * @param string $last_name + * + * @return $this + */ + public function setLastName($last_name) + { + $this->last_name = $last_name; + + return $this; + } + + + /** + * @return string + */ + public function getEmail() + { + return $this->email; + } + + + /** + * @param string $email + * + * @return $this + */ + public function setEmail($email) + { + $this->email = $email; + + return $this; + } + + + /** + * @return string + */ + public function getPhone() + { + return $this->phone; + } + + + /** + * @param string $phone + * + * @return $this + */ + public function setPhone($phone) + { + $this->phone = $phone; + + return $this; + } + + + /** + * @return string + */ + public function getTenantType() + { + return $this->tenant_type; + } + + + /** + * @param string $tenant_type + * + * @return $this + */ + public function setTenantType($tenant_type) + { + $this->tenant_type = $tenant_type; + + return $this; + } + + + /** + * @return string + */ + public function getEnquiryMethod() + { + return $this->enquiry_method; + } + + + /** + * @param string $enquiry_method + * + * @return $this + */ + public function setEnquiryMethod($enquiry_method) + { + $this->enquiry_method = $enquiry_method; + + return $this; + } + + + /** + * @return string + */ + public function getEnquiryType() + { + return $this->enquiry_type; + } + + + /** + * @param string $enquiry_type + * + * @return $this + */ + public function setEnquiryType($enquiry_type) + { + $this->enquiry_type = $enquiry_type; + + return $this; + } + + + /** + * @return string + */ + public function getMessage() + { + return $this->message; + } + + + /** + * @param string $message + * + * @return $this + */ + public function setMessage($message) + { + $this->message = $message; + + return $this; + } +} diff --git a/src/Models/EnquirySaved.php b/src/Models/EnquirySaved.php new file mode 100644 index 0000000..ceafc01 --- /dev/null +++ b/src/Models/EnquirySaved.php @@ -0,0 +1,36 @@ +enquiry_id; + } + + + /** + * @param string $enquiry_id + * + * @return $this + */ + public function setEnquiryId($enquiry_id) + { + $this->enquiry_id = $enquiry_id; + + return $this; + } +} diff --git a/src/Requests/PostEnquiry.php b/src/Requests/PostEnquiry.php new file mode 100644 index 0000000..71bea1e --- /dev/null +++ b/src/Requests/PostEnquiry.php @@ -0,0 +1,52 @@ +body = json_encode($enquiry, JSON_THROW_ON_ERROR); + } + + + public function __construct($version) + { + $this->version = $version; + } + + + /** + * @return \SturentsLib\Api\Models\EnquirySaved|\SturentsLib\Api\Models\SendDataError|\SturentsLib\Api\Models\AuthError|\SturentsLib\Api\Models\Error|list<\SturentsLib\Api\Models\EnquirySaved>|list<\SturentsLib\Api\Models\SendDataError>|list<\SturentsLib\Api\Models\AuthError>|list<\SturentsLib\Api\Models\Error> + */ + public function sendWith(SwaggerClient $client) + { + return $client->make($this, [ + '200' => \SturentsLib\Api\Models\EnquirySaved::class, + '400' => \SturentsLib\Api\Models\SendDataError::class, + '401' => \SturentsLib\Api\Models\AuthError::class, + '403' => \SturentsLib\Api\Models\AuthError::class, + '404' => \SturentsLib\Api\Models\Error::class, + 'default' => \SturentsLib\Api\Models\Error::class + ]); + } +} diff --git a/swagger/api-channel.yml b/swagger/api-channel.yml index ce1c898..dbf3131 100644 --- a/swagger/api-channel.yml +++ b/swagger/api-channel.yml @@ -182,6 +182,47 @@ paths: $ref: '#/definitions/GetError' default: $ref: '#/definitions/Error' + /enquiry: + post: + summary: Submit a tenant enquiry + description: | + Channel-facing endpoint for submitting a tenant enquiry against a specific + property/contract term. Auth follows the same channel HMAC pattern as + other v3 API endpoints (timestamp + SHA256 HMAC of body+timestamp using + the channel's public key). + security: + - Channel: [] + PropertyManager: [] + Timestamp: [] + Auth: [] + parameters: + - in: query + name: version + type: string + required: true + description: | + Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' + - in: body + name: Enquiry + schema: + $ref: '#/definitions/EnquiryCreation' + tags: + - Property listings + responses: + '200': + description: Indicates the created enquiry ID + schema: + $ref: '#/definitions/EnquirySaved' + '400': + $ref: '#/definitions/SendDataError' + '401': + $ref: '#/definitions/AuthError' + '403': + $ref: '#/definitions/AuthError' + '404': + $ref: '#/definitions/Error' + default: + $ref: '#/definitions/Error' definitions: GetError: description: | @@ -200,6 +241,17 @@ definitions: error: type: string description: Message indicating the rate limit has been exceeded and when to try again + SendDataError: + description: | + There were problems with the input data in the request body. + These will be described in the "messages" field of the response + type: object + properties: + messages: + type: array + description: Keyed by field name (collapsed using . characters) + items: + type: string AuthError: description: | The key supplied did not match the property manager or channel @@ -984,3 +1036,51 @@ definitions: type: string description: | Date and time that the room summary was last updated + EnquiryCreation: + type: object + required: + - property_id + - contract_id + - first_name + - last_name + - email + - phone + - tenant_type + - enquiry_method + - enquiry_type + properties: + property_id: + type: integer + description: Plain (non-hashed) house id + contract_id: + type: string + description: Hashed availability id + first_name: + type: string + last_name: + type: string + email: + type: string + format: email + phone: + type: string + tenant_type: + type: string + enum: [student, professional, guardian] + enquiry_method: + type: string + enum: [phone, message] + enquiry_type: + type: string + enum: [enquire, book, viewing] + message: + type: string + description: | + Optional free-text message; used as the enquiry subject if provided, + otherwise a label derived from enquiry_type is used + EnquirySaved: + type: object + properties: + enquiry_id: + type: string + description: Hashed id of the created enquiry diff --git a/swagger/api.yml b/swagger/api.yml index 1075cba..af4215b 100644 --- a/swagger/api.yml +++ b/swagger/api.yml @@ -697,6 +697,48 @@ paths: $ref: '#/definitions/GetError' default: $ref: '#/definitions/Error' + /enquiry: + post: + summary: Submit a tenant enquiry + description: | + Channel-facing endpoint for submitting a tenant enquiry against a specific + property/contract term. Auth follows the same channel HMAC pattern as + other v3 API endpoints (timestamp + SHA256 HMAC of body+timestamp using + the channel's public key). + security: + - Channel: [] + PropertyManager: [] + Timestamp: [] + Auth: [] + parameters: + - in: query + name: version + type: string + required: true + description: | + Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' + - in: body + name: Enquiry + schema: + $ref: '#/definitions/EnquiryCreation' + tags: + - Changing data on StuRents + - Enquiries + responses: + '200': + description: Indicates the created enquiry ID + schema: + $ref: '#/definitions/EnquirySaved' + '400': + $ref: '#/definitions/SendDataError' + '401': + $ref: '#/definitions/AuthError' + '403': + $ref: '#/definitions/AuthError' + '404': + $ref: '#/definitions/Error' + default: + $ref: '#/definitions/Error' definitions: GetError: description: | @@ -1550,6 +1592,54 @@ definitions: media_id: type: string description: Unique reference to the Media item on StuRents + EnquiryCreation: + type: object + required: + - property_id + - contract_id + - first_name + - last_name + - email + - phone + - tenant_type + - enquiry_method + - enquiry_type + properties: + property_id: + type: integer + description: Plain (non-hashed) house id + contract_id: + type: string + description: Hashed availability id + first_name: + type: string + last_name: + type: string + email: + type: string + format: email + phone: + type: string + tenant_type: + type: string + enum: [student, professional, guardian] + enquiry_method: + type: string + enum: [phone, message] + enquiry_type: + type: string + enum: [enquire, book, viewing] + message: + type: string + description: | + Optional free-text message; used as the enquiry subject if provided, + otherwise a label derived from enquiry_type is used + EnquirySaved: + type: object + properties: + enquiry_id: + type: string + description: Hashed id of the created enquiry Error: type: object properties: From 0a1ea0327c287e1311a3bcfff441a94c0b52c2a9 Mon Sep 17 00:00:00 2001 From: johncroker Date: Mon, 14 Sep 2026 16:10:06 +0100 Subject: [PATCH 2/7] add inbound flag --- src/Models/PropertyManager.php | 30 ++++++++++++++++++++++++++++++ swagger/api-channel.yml | 5 +++++ swagger/api.yml | 5 +++++ 3 files changed, 40 insertions(+) diff --git a/src/Models/PropertyManager.php b/src/Models/PropertyManager.php index d95512b..b62619c 100644 --- a/src/Models/PropertyManager.php +++ b/src/Models/PropertyManager.php @@ -34,6 +34,14 @@ class PropertyManager extends SwaggerModel */ protected $company = ''; + /** + * True if the landlord has given the channel permission to send + * enquiries for their listings (e.g. via POST /enquiry) + * + * @var bool + */ + protected $inbound_data_enabled = false; + /** * @return string @@ -121,4 +129,26 @@ public function setCompany($company) return $this; } + + + /** + * @return bool + */ + public function getInboundDataEnabled() + { + return $this->inbound_data_enabled; + } + + + /** + * @param bool $inbound_data_enabled + * + * @return $this + */ + public function setInboundDataEnabled($inbound_data_enabled) + { + $this->inbound_data_enabled = $inbound_data_enabled; + + return $this; + } } diff --git a/swagger/api-channel.yml b/swagger/api-channel.yml index dbf3131..c45d650 100644 --- a/swagger/api-channel.yml +++ b/swagger/api-channel.yml @@ -843,6 +843,11 @@ definitions: type: string description: | ID for the organisation this account belongs to on the StuRents website + inbound_data_enabled: + type: boolean + description: | + True if the landlord has given the channel permission to send + enquiries for their listings (e.g. via POST /enquiry) Error: type: object properties: diff --git a/swagger/api.yml b/swagger/api.yml index af4215b..bef6e28 100644 --- a/swagger/api.yml +++ b/swagger/api.yml @@ -1560,6 +1560,11 @@ definitions: type: string description: | ID for the organisation this account belongs to on the StuRents website + inbound_data_enabled: + type: boolean + description: | + True if the landlord has given the channel permission to send + enquiries for their listings (e.g. via POST /enquiry) BankAccount: properties: descriptor: From ea0a18b13469394d33746364a582b77bb2d88aad Mon Sep 17 00:00:00 2001 From: johncroker Date: Mon, 14 Sep 2026 16:29:01 +0100 Subject: [PATCH 3/7] update endpoint description --- src/Requests/GetProperties.php | 16 +++++++++++++++- src/Requests/GetSummary.php | 16 ++++++++++++++++ swagger/api-channel.yml | 6 ++++++ swagger/api.yml | 6 ++++++ 4 files changed, 43 insertions(+), 1 deletion(-) diff --git a/src/Requests/GetProperties.php b/src/Requests/GetProperties.php index b6203e8..4bf763b 100644 --- a/src/Requests/GetProperties.php +++ b/src/Requests/GetProperties.php @@ -20,7 +20,15 @@ class GetProperties extends SwaggerRequest * @var null */ public $page; - protected static array $query_params = ['page']; + + /** + * Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' + * + * + * @var null + */ + public $version; + protected static array $query_params = ['page', 'version']; public function setPage($page) @@ -29,6 +37,12 @@ public function setPage($page) } + public function __construct($version) + { + $this->version = $version; + } + + /** * @return \SturentsLib\Api\Models\ListProperties|\SturentsLib\Api\Models\Error|\SturentsLib\Api\Models\AuthError|\SturentsLib\Api\Models\GetError|\SturentsLib\Api\Models\RateLimitError|list<\SturentsLib\Api\Models\ListProperties>|list<\SturentsLib\Api\Models\Error>|list<\SturentsLib\Api\Models\AuthError>|list<\SturentsLib\Api\Models\GetError>|list<\SturentsLib\Api\Models\RateLimitError> */ diff --git a/src/Requests/GetSummary.php b/src/Requests/GetSummary.php index e80d63d..fccd714 100644 --- a/src/Requests/GetSummary.php +++ b/src/Requests/GetSummary.php @@ -10,6 +10,22 @@ class GetSummary extends SwaggerRequest public const METHOD = 'GET'; public const URI = '/api/summary'; + /** + * Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' + * + * + * @var null + */ + public $version; + protected static array $query_params = ['version']; + + + public function __construct($version) + { + $this->version = $version; + } + + /** * @return \SturentsLib\Api\Models\PropertyManager|\SturentsLib\Api\Models\Error|\SturentsLib\Api\Models\AuthError|\SturentsLib\Api\Models\GetError|list<\SturentsLib\Api\Models\PropertyManager>|list<\SturentsLib\Api\Models\Error>|list<\SturentsLib\Api\Models\AuthError>|list<\SturentsLib\Api\Models\GetError> */ diff --git a/swagger/api-channel.yml b/swagger/api-channel.yml index c45d650..4450ad0 100644 --- a/swagger/api-channel.yml +++ b/swagger/api-channel.yml @@ -190,6 +190,12 @@ paths: property/contract term. Auth follows the same channel HMAC pattern as other v3 API endpoints (timestamp + SHA256 HMAC of body+timestamp using the channel's public key). + + The landlord must have explicitly enabled your channel to send them + enquiries before this endpoint will accept requests for their properties. + Check the "inbound_data_enabled" field returned by GET /summary for each + property manager to see whether this has been enabled - if it is false, + requests to this endpoint for that landlord will be rejected with a 403. security: - Channel: [] PropertyManager: [] diff --git a/swagger/api.yml b/swagger/api.yml index bef6e28..ba9b706 100644 --- a/swagger/api.yml +++ b/swagger/api.yml @@ -705,6 +705,12 @@ paths: property/contract term. Auth follows the same channel HMAC pattern as other v3 API endpoints (timestamp + SHA256 HMAC of body+timestamp using the channel's public key). + + The landlord must have explicitly enabled your channel to send them + enquiries before this endpoint will accept requests for their properties. + Check the "inbound_data_enabled" field returned by GET /summary for each + property manager to see whether this has been enabled - if it is false, + requests to this endpoint for that landlord will be rejected with a 403. security: - Channel: [] PropertyManager: [] From 4d7daa31954c90994d6d20ae300d6416e6f6a1a7 Mon Sep 17 00:00:00 2001 From: johncroker Date: Tue, 15 Sep 2026 11:40:49 +0100 Subject: [PATCH 4/7] version query param is not required --- src/Requests/GetProperties.php | 2 +- src/Requests/GetSummary.php | 2 +- src/Requests/PostEnquiry.php | 2 +- swagger/api-channel.yml | 6 +++--- swagger/api-display.yml | 2 +- swagger/api-upload.yml | 2 +- swagger/api.yml | 6 +++--- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/src/Requests/GetProperties.php b/src/Requests/GetProperties.php index 4bf763b..98db3c9 100644 --- a/src/Requests/GetProperties.php +++ b/src/Requests/GetProperties.php @@ -37,7 +37,7 @@ public function setPage($page) } - public function __construct($version) + public function setVersion($version) { $this->version = $version; } diff --git a/src/Requests/GetSummary.php b/src/Requests/GetSummary.php index fccd714..13bec55 100644 --- a/src/Requests/GetSummary.php +++ b/src/Requests/GetSummary.php @@ -20,7 +20,7 @@ class GetSummary extends SwaggerRequest protected static array $query_params = ['version']; - public function __construct($version) + public function setVersion($version) { $this->version = $version; } diff --git a/src/Requests/PostEnquiry.php b/src/Requests/PostEnquiry.php index 71bea1e..2abe431 100644 --- a/src/Requests/PostEnquiry.php +++ b/src/Requests/PostEnquiry.php @@ -29,7 +29,7 @@ public function setBody(\SturentsLib\Api\Models\EnquiryCreation $enquiry) } - public function __construct($version) + public function setVersion($version) { $this->version = $version; } diff --git a/swagger/api-channel.yml b/swagger/api-channel.yml index 4450ad0..112b630 100644 --- a/swagger/api-channel.yml +++ b/swagger/api-channel.yml @@ -65,7 +65,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' tags: @@ -111,7 +111,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' tags: @@ -205,7 +205,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' - in: body diff --git a/swagger/api-display.yml b/swagger/api-display.yml index 80f7626..33cf0bf 100644 --- a/swagger/api-display.yml +++ b/swagger/api-display.yml @@ -62,7 +62,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' tags: diff --git a/swagger/api-upload.yml b/swagger/api-upload.yml index e8ffad5..f0a8eb3 100644 --- a/swagger/api-upload.yml +++ b/swagger/api-upload.yml @@ -84,7 +84,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' tags: diff --git a/swagger/api.yml b/swagger/api.yml index ba9b706..6885d95 100644 --- a/swagger/api.yml +++ b/swagger/api.yml @@ -98,7 +98,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' tags: @@ -135,7 +135,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' responses: @@ -720,7 +720,7 @@ paths: - in: query name: version type: string - required: true + required: false description: | Should be set to "3" (defaults to "1.3" if not set and the 1.3 version is deprecated)' - in: body From 1de8bdc3627932e786351943e21e7a68d68e5264 Mon Sep 17 00:00:00 2001 From: johncroker Date: Tue, 15 Sep 2026 12:56:11 +0100 Subject: [PATCH 5/7] add body to auth for channel --- src/ChannelClient.php | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/src/ChannelClient.php b/src/ChannelClient.php index 855ad95..817b5c0 100644 --- a/src/ChannelClient.php +++ b/src/ChannelClient.php @@ -18,16 +18,15 @@ public function __construct(string $landlord_id, string $channel_id, string $dis protected function authQuery(RequestInterface $request): array{ $timestamp = time(); - $auth = $this->generateAuth((string)$timestamp); + $auth = $this->generateAuth((string)$request->getBody(), (string)$timestamp); return [ 'auth' => $auth, 'timestamp' => $timestamp, - 'channel' => $this->channel_id, ]; } - private function generateAuth(string $timestamp): string{ - return hash_hmac('sha256', $timestamp, $this->display_key) ?: ''; + private function generateAuth(string $json, string $timestamp): string{ + return hash_hmac('sha256', $json.$timestamp, $this->display_key) ?: ''; } } From 460d143938fb8c16ef3245480614f82b714010c7 Mon Sep 17 00:00:00 2001 From: johncroker Date: Tue, 15 Sep 2026 14:30:07 +0100 Subject: [PATCH 6/7] channel_id query param --- src/ChannelClient.php | 1 + 1 file changed, 1 insertion(+) diff --git a/src/ChannelClient.php b/src/ChannelClient.php index 817b5c0..f4aaa3e 100644 --- a/src/ChannelClient.php +++ b/src/ChannelClient.php @@ -23,6 +23,7 @@ protected function authQuery(RequestInterface $request): array{ return [ 'auth' => $auth, 'timestamp' => $timestamp, + 'channel' => $this->channel_id, ]; } From a4a9a76dbf8423d60f3831ce82de48b733f929b9 Mon Sep 17 00:00:00 2001 From: johncroker Date: Thu, 17 Sep 2026 15:15:53 +0100 Subject: [PATCH 7/7] change enquiry flag name --- src/Models/PropertyManager.php | 12 ++++++------ swagger/api-channel.yml | 4 ++-- swagger/api.yml | 4 ++-- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/src/Models/PropertyManager.php b/src/Models/PropertyManager.php index b62619c..64bbbc0 100644 --- a/src/Models/PropertyManager.php +++ b/src/Models/PropertyManager.php @@ -40,7 +40,7 @@ class PropertyManager extends SwaggerModel * * @var bool */ - protected $inbound_data_enabled = false; + protected $can_send_enquiries = false; /** @@ -134,20 +134,20 @@ public function setCompany($company) /** * @return bool */ - public function getInboundDataEnabled() + public function getCanSendEnquiries() { - return $this->inbound_data_enabled; + return $this->can_send_enquiries; } /** - * @param bool $inbound_data_enabled + * @param bool $can_send_enquiries * * @return $this */ - public function setInboundDataEnabled($inbound_data_enabled) + public function setCanSendEnquiries($can_send_enquiries) { - $this->inbound_data_enabled = $inbound_data_enabled; + $this->can_send_enquiries = $can_send_enquiries; return $this; } diff --git a/swagger/api-channel.yml b/swagger/api-channel.yml index 112b630..8a9f78d 100644 --- a/swagger/api-channel.yml +++ b/swagger/api-channel.yml @@ -193,7 +193,7 @@ paths: The landlord must have explicitly enabled your channel to send them enquiries before this endpoint will accept requests for their properties. - Check the "inbound_data_enabled" field returned by GET /summary for each + Check the "can_send_enquiries" field returned by GET /summary for each property manager to see whether this has been enabled - if it is false, requests to this endpoint for that landlord will be rejected with a 403. security: @@ -849,7 +849,7 @@ definitions: type: string description: | ID for the organisation this account belongs to on the StuRents website - inbound_data_enabled: + can_send_enquiries: type: boolean description: | True if the landlord has given the channel permission to send diff --git a/swagger/api.yml b/swagger/api.yml index 6885d95..e768146 100644 --- a/swagger/api.yml +++ b/swagger/api.yml @@ -708,7 +708,7 @@ paths: The landlord must have explicitly enabled your channel to send them enquiries before this endpoint will accept requests for their properties. - Check the "inbound_data_enabled" field returned by GET /summary for each + Check the "can_send_enquiries" field returned by GET /summary for each property manager to see whether this has been enabled - if it is false, requests to this endpoint for that landlord will be rejected with a 403. security: @@ -1566,7 +1566,7 @@ definitions: type: string description: | ID for the organisation this account belongs to on the StuRents website - inbound_data_enabled: + can_send_enquiries: type: boolean description: | True if the landlord has given the channel permission to send