Links

What’s New

We are constantly working to improve your experience with the Platform. Have a look to see what new features and fixes have been released.

30/12/22

Applicants API

Custom applicant attributes that are usually captured on the requirements screen under ‘Must Have’ or ‘Special/Special Requirements’, are now surfaced for applicants under ‘specialFeatures’:
Applicant Requirements screen in AgencyCloud
Example Special Features Data
The ‘Renting Position’ is now surfaced on an applicant under ‘renting.positionId’:
Applicant status screen in AgencyCloud
Example 'positionId'
Note: The renting position list is configurable and can be cross referenced against a new sub-resource under the Configuration endpoint ‘GET /configuration/rentingPositions’.

Transactions API

You can now create pending supplier invoices using the new sub-resource under the Transactions endpoint ‘POST /transactions/supplierInvoices’:
For the full specification, validation, and behaviours, please review ticket https://github.com/reapit/foundations/issues/7764 in conjunction with the swagger documentation.

Analytics Schema

‘Tenancy Alterations’ data is now included in the Analytics Schema:
Analytics Schema

30/11/22

Applicants API

It is now possible to set an applicant as a Potential Client (potentialClient):
Applicant Status screen showing the 'Potential Client' field In AgencyCloud
Potential Client field
We are now surfacing remaining lease (leaseRemaining) information on Applicants:
Applicant Requirements screen showing the 'Remaining Lease' fields in AgencyCloud
Reaming Lease field

Analytics Schema

'Pre Instruction Checks' data is now included in the Analytics Schema:

Journal API

We now support the option to POST to the Journals endpoint the following letter types:
Arrears Letter (AL), Notice to Quit Letter (NQ), Tenancy Renewal Letter (TR), Letter Sent (LE)
Please note: In the case of AL/NQ/TR the associated type MUST be ‘tenancy’.

Properties API

The ‘Text’ field (urlcaption) is now both read and write:
Marketing Screen showing the 'Text' field in AgencyCloud
Text field

31/10/22

Analytics Schema

'Referral' data is now available within the Analytics Schema:

Contacts API

It is now possible to update the ‘marketingConsent’ field on an archived contact record:
Please note: Only the Marketing Consent field on an archived record can be updated.

AppMarket 2.0

As you may have already seen, on Wednesday 26th, we launched the latest version of the AppMarket. The updated AppMarket includes and now supports, app name & developer searching, new categories and filter options plus featured apps and app collections:
Part of the redesign will now allow customers on Rackspace, to view apps that were previously hidden due to the compatibility with AWS. Whilst they still will not be able to install or enable integrations that use data Webhooks, they will now be able to enquire about the app/integration, view the marketing materials and videos.
The new AppMarket now also includes the ability for Developers to add videos to their app listings. ‘Getting Started’ & a ‘Why’ video. For information on how to add a video to your app listing, please click here.

Applicants API

Applicant Tenure information is now available in the Applicants ‘Buying’ modal:

Companies API

We now support filtering on the Companies endpoint by Office Groups.
For more information on office groups, please visit https://foundations-documentation.reapit.cloud/faqs#what-are-office-groups

Tenancies API

‘Allowances’ can now be created and updated:
‘Break Clauses’ can also be created and updated:
And also for ‘Responsibilities’:

Metadata API

It is now possible to patch nested objects in the Metadata API

Properties API

We have exposed the ValuationDate & AgreementExpiry dates under the property selling model

Developer Portal

Videos
Applistings now support the ability to add video URL's. Under the section 'AppMarket Listing', you'll see 2 new fields:
The video's will then be rendered in the AppMarket:
Please note: We recommend strongly that if you do upload videos, to use the online streaming site YouTube.
App Deletion
To prevent accidental data loss, we have added an additional layer of protection for apps. On each app, under the section ‘AppMarket Listing’, you will now see the following check box:
If you should then accidentally select ‘Delete’, you’ll be prompted the following message and will need to disable the additional protection before you can delete the app:
Please Note: The app data protection check box is not selected by default so, to ensure your apps and its associated data are protected, please review your app listing.

30/09/22

Properties API

Unmapped attributes:
Property and Applicant attributes/requirements (department data) is completely customisable for each agent and subsequently it can be difficult to understand how to interpret this data as it comes out of the various APIs that expose it.
As the Platform APIs are standardised across all our customers, Department data has also been standardised where possible using a mapping mechanism to map the customisable values from our CRM into standard values in the API.
Any options that do not have a corresponding mapping and are selected on a Property or Applicant entity will be included in the unmappedAttributes and unmappedRequirements collections in their respective APIs. Additionally, the Special attributes column in the CRM is mapped explicitly.
Example payload:
Fields:
The Properties API now displays the Maximum Reception/Bathroom ranges:

Journals API

It is now possible to create a Works Orders journal entry:
Note: TypeID must be set to 'WO' when passing worksOrder

Companies API

We now support filtering on the Companies endpoint by Negotiator and Office:

Applicant API

Applicant ReasonID and SellingPosition now available using POST and PATCH methods:

Integration Types

New ‘Diary’ desktop integration type now available from version 12.152.3. App’s that have selected ‘Dairy’ as the integration type will be launched from an existing appointment. For more information, please click here.

30/08/22

Tenancies API

It is now possible to read deposit and deposit holder information via the tenancies API. This information can also be written back up to a certain status:
It is now possible to filter tenancy checks by type:

Properties API

Market Appraisal (valuation) price now available:
Pre-Instruction checks can now be managed via /properties/{id}/checks:

Applicants API

It is now possible to find applicants by phone number (and any other contact detail):

Webhooks API

Webhook transactions can now be filtered much more granularly to allow you to find transactions more easily (Topic name, Entity ID & Event ID):

Enquiries API

The validation has been updated to more closely match the contacts API

29/07/22

Referrals API - Phase 2

The Referrals API has now been enhanced to support updating (PATCH) and the ability to store metadata:

Properties API

It is now possible to see the Id’s of disabled portals set against a property:
The ID’s are stored on the configuration endpoint for portalTypes.
You can now filter properties by AreaId:
Our multi currency support milestone has been completed. It will be most beneficial for UK customers that advertise international properties. For more information, please review our milestone here.

Enquiries API

When creating a new enquiry (which is visible on the Internet Registration panel in AgencyCloud) you can now pass price/bedroom requirements for sales and lettings applicant enquiries:

Journal API

We have added support to allow retrieval of ‘tenancy’ journal entries.

27/06/22

Rural property data is now exposed with certain fields writeable under the ‘rural’ section on a property:
Lettings management fees, type and amount now available under the ‘managementFee’ section:
Number of units (numberOfUnits) in a development now available:
Minimum tenancy term (minimumTerm) now available for lettings properties:
smallHolding’, ‘estate’ & ‘developmentOpportunity’ property types are now available via the Properties, Departments & Applicants endpoints. Please note, the additional types are only available in some customer's systems. The 'Departments' endpoint should be used to understand the configuration of a specific customer.
Contact categories can now be retrieved using the ‘Configuration’ endpoint ‘contactCategories/{id} and can also be set on a ‘Contact’:
Public brochure URLs (publicBrochureUrl) are now available in the Properties API under either the ‘Selling’ or ‘Letting’ object:
A works order note (worksOrderNote) can now be added at the property level which will cascade down to any works order for that property in Agency Cloud:
Office status can now be obtained from the Offices API so you can understand whether an office is open or closed based on the field type ‘active’:

24/05/22

Referrals - Phase 1

Last week, we released the first phase of the ‘Referrals’ endpoint which includes the following:
The second phase will include the ability to write to the endpoint, metadata & associated webhooks. You can track the phase 2 milestone here

New features

Journal Entries: You can now store a journal entry of Match (MA) against a property or applicant record Bedroom Range: The ‘Max’ bedroom range is now exposed in the Properties API – this is most useful for marketing of property developments. Properties: We have added support for Juliette Balcony (property situation), Studio (property style) and Villa (property type). Companies: Additional contact information is now available for companies. The additional information is available in ‘additionalContactDetails' object:
Transactions: It is now possible to filter transactions by ‘Outstanding’ amount.

Developer Portal Release

The latest release of the Developer Portal (v3.0.5) included the re design of the following pages… Settings: We have updated the UI within the settings section in accordance with our design system and the other pages within the portal. The options available to you when accessing settings will be dependent on your user level:
Admins of an organisation can set the level of users (members) on the ‘Members’ page. Analytics: We have separated the features and information available to you in specific sections: ‘API Usage’, ‘Costs’ & ‘Installations’.
You can use the filters on the left-hand side to set the data results for each page.

Design System

In the latest release of our Design System Figma file, we introduced new button states and a new component. We have also fixed a few bugs and revised/added additional documentation for buttons. New Features
  • Disable and hover states for desktop buttons
  • Disable state for mobile buttons
  • New medium size infographic icon (Manage App Listing)
  • File Upload component

Bug Fixes

  • Measurements: misspelling on the red static button; it was 38px, now it’s 40px
  • Measurements: misspelling on the ‘One Choice Chips’ component - active state, selected chip, padding was 4px and now it’s 3x, margins were 3px and now it’s 4px
  • Documentation about button types was added to all components that use them
  • Static button with icon has been documented
  • Static button width size for mobile has been increased to 120px
  • Guidelines for static and dynamic buttons have been revised
  • Desktop - Full Options Expansion Panel: button margins and distance between buttons and content have been revised

01/04/22

Trading Standards – Material Information Requirement

We are pleased to confirm, the Properties API has been updated to provide the following information ahead of the Material Information requirement by the end of May 2022. Related information here.
The following fields are available:
  • Council Tax Band (councilTax)
  • Local Authority (localAuthorityCompanyId)
  • Ground rent for leasehold properties (groundRent & groundRentComment)
  • Maintenance charges for leasehold properties (serviceCharge & serviceChargeComment)
  • Leasehold length (tenure.expiry)

Webhook Enhancements

Last week, we updated our Webhook functionality to increase throughput and to reduce latency. We have seen a significant improvement already. We have enhanced the way in which we process webhook events. Nothing has changed for you in how you create or manage your webhooks but the background service has been re developed to better increase the rate in which they are emitted.

Additional fields

Deposit Data (Type & Amount) is now available inside the Lettings object on Properties API under ‘deposit’:

Additional Filtering

Properties by Negotiator ID(s)
Properties by Country ID:

GitHub Username Field

To better help us identify the company you are associated to and help with triaging tickets that are raised via GitHub, you can now save your GitHub username on your ‘Profile’ page in the DeveloperPortal:

Help is moving

The 'Help' page is moving into our main documentation. The 'Help' icon on the main navigation will soon no longer be visible but you can still access help by going to 'Docs > Help'.

24/03/22

New Release

This week, we have released a new version of the Developer Portal, specifically an updated version of the app creation flow and app edit pages.
The new design has been developed to improve the UI (now using Elements V3) and to improve the user experience. We’ve also added a very helpful new feature. Read below to find out more.

App Creation

To better help you navigate the app creation process, we have included a helpful app creation wizard. The wizard is designed to make creating an app as straightforward as possible by preselecting/populating certain fields based on your use case.
You can select the type of integration from the list below:
Or if none of the above suit your requirements, simply scroll down and select either a Client-side app or Server-side Integration:
With every selection, we will present the associated documentation on the right-hand side to help you with the process.
You’ll find helpful links for more information or on certain selections, a short video.
When you have completed the wizard, you’ll be directed to the ‘App Details’ page. This page will contain all the information you need to get started developing right away, such as the Client ID and or Client Secret:
The app name will be pre-populated based on your company name. You can change this at any stage.
To edit your app, simply click ‘Edit App’ from the left-hand navigation.
Depending on what type of app you have selected from the wizard, you’ll be presented with various tabs. The first tab for all types is the ‘About Listings’.

New Feature

On the ‘Edit App’ page is where we have introduced a new feature ‘Check Status’.
The check status button is a very quick and easy way to see the current status of your app, what information is missing, your AppMarket status and to see if have any changes that require saving.
The process for submitting your app for review is the same as before. Simply check the status of your app and once all checks have been completed (see example below):
A button on the left-hand side will appear ‘Submit Review’. This will create a revision to our Admin team.
Once your app has been approved (please click here for more information on the reviewal process) the button will change to present the option to ‘Delist’ your app.
The additional tabs, as mentioned previously, will depend on your app type but in all cases, you will have an ‘AppMarket Listing’ and a ‘Permissions’ tab.
The ‘AppMarket Listing’ tab captures the app listing content for the AppMarket and will need to be completed before submitting your app. Images, description, contact information etc.
The ‘Permissions’ tab will relate to the endpoints and data sets you wish to interact with and the visibility of your app (either public or private).
For other types of integrations, you will see the tabs for AgencyCloud Integration and Authentication.
We will be continuing to update the Developer Portal in the coming months to further enhance the user experience and features available to you.

14/03/22

Works Orders

You can now interact and launch with the native works orders screen and pre populate certain search criteria using the newly added AgencyCloud scheme:
agencycloud://worksorders/{id}
For more information on Works Orders, please click here

Match Output Integration Type

The category of Match Output would enable an application to be used to export the details of a match either from an applicant to a property or a property to an applicant.
An app with the integration type 'Match Output' will be visible by selecting 'Print' after running a match:
For more information on Match Output, please click here

10/03/22

Property URL

We are now returning (when manually entered) the Property URL, which is accessible from the 'Marketing' screen:
Properties Endpoint
Marketing Screen in AgencyCloud
Please note: The URL will only be returned when it has been explicitly set. Default URLs' will not be available.

23/02/22

The featured property image (featuredImageUrl) is now being returned in the properties object, without the need to embed or make an additional call to the property images endpoint. This will be mostly beneficial for website integrations for property results.

Property Manager Information

We are now returning the Property Manager ID (propertyManagerId) within the lettings object on a property.

Additional Extras support for Landlords and Works Orders

We have now added the ability for users to request additional extras fields for Works Orders and Landlords.
Also, you can now filter by ‘QuoteAccepted’ on Works Orders.

Code generation

We have now updated our code generation mechanism to now support office specific referencing.

10/12/21

We have recently updated our Development Request documentation to now include a FAQ’s section. Part of the update to the documentation includes a detailed description on each label, column and board. Please take the time to review the updated documentation and ensure you understand how feature requests and bugs are triaged via the Platform. In addition to the updated documentation, we will shortly be implementing a ‘GitBot’. The GitBot is designed to auto reply to specific issues raised, when issues are moved to certain columns, assigned specific project boards or certain labels added. Essentially, an automated comment to will be added to the issue which will help explain the reason a specific label was added, why it was moved to a certain column and the time frame in which we expect the work to be completed by. The automated email will be sent the person that raised the issue or anyone that has subscribed. If you would like to receive a notification (email) to an issue you are following but have not raised, please make sure you are subscribed, using the ‘Subscribe’ option from the right-hand navigation. Please do not contact our service desk, customer success managers or any other channels within Reapit with regard to the status or timeline of an issue. Please first refer to the documentation and communicate with developers directly in GitHub.

13/09/21

Troubleshooting

We have introduced a new section in our documentation ‘Troubleshooting’.
The documentation is intended to provide guidance to our Developers when building apps and integrations through the Developer Portal.
Currently, it offers support on the following topics:
We will continue to add and update this section but don’t forget, we also have a dedicated page for FAQ's, which can be found here.
Remember, if you are having an issue not covered in the documentation or you have discovered a bug, please raise an issue on our public board by clicking here.

Notification Email

The email address you entered when registering for the Developer Portal, is used by default to receive email notifications,. For example, when your app is installed from the AppMarket, you will receive an email with the details (see more information here)
As you cannot change the email address that registered your organisation, we have now provided the ability to supply an alternative ‘Notifications Email’.
If you want to setup an alternative email address, simply go to ‘Organisation’ page.
Please note: Only an Admin will have the correct permissions to update this information.

Certificates

We are pleased to announce have added new endpoints to the Properties endpoint to now allow for reading and writing of ‘Certificates’.
In conjunction with the new entities, we have also added to our Configuration endpoint, the ability to surface CertificateTypes.

25/06/2021

Webhooks Transaction Logs

We have now included a ‘Transactions Logs’ section on the ‘Webhooks’ page, to allow you to filter your transactional Webhook history by date and app. To view your webhook transaction logs, simply navigate to the ‘Webhooks’ page inside of the Developer Portal, select a date range (will default to the last 7 days) and select an app:
From each log item, you will be able to see the URL, the selected topic, status and the option to ‘Download’.
Selecting ‘Download’ will save a copy of the specific payload as a JSON file.

New Webhook Topics

We have added the following new Webhook topics: appointments.cancelled appointments.confirmed contacts.optedout enquiries.accepted enquiries.rejected offers.rejected offers.withdrawn offers.accepted properties.selling.askingpricechanged properties.selling.completed properties.selling.exchanged properties.selling.withdrawn properties.selling.instructed properties.selling.lostinstruction properties.selling.underoffer worksorders.cancelled worksorders.complete worksorders.raised If you wish to setup subscriptions to any of the new the topics listed above, you will need to have selected the associated scopes. For more information on the required scopes, please visit the associated documentation here.

New REST Hooks Endpoint

We have introduced a new REST Hooks Endpoint. This functionality allows you to programmatically set up webhook notifications for your application rather than needing to do this manually using the ‘Webhooks’ page in the developer portal which can help you automate onboarding of customers.

Updated Terms and Conditions

We continue to develop new features and products on the Foundations Platform and have updated our Terms and Conditions to reflect these changes. From 25th June, when you next login to the Developer Portal, you will be presented with the latest updated terms and will need to accept before continuing to use the Developer Portal. Our current and revised terms can be accessed through the Developer Portal documentation under ‘Developer Terms and Conditions’.

04/05/2021

New Desktop Integration Types

Our desktop integration types have been extended to now include the following communication types included in AgencyCloud from version 12.130.1 :
  • Outbound – Email
  • Outbound – Landline
  • Outbound – Mobile
On each communication type, the Desktop API will provide a 'cntCode' and relevant communication information, either email, landline number or mobile number.
App that’s have any of the above desktop integration types will be visible in AgencyCloud when right clicking on the relevant icon, please see example below:
The Developer Edition of AgencyCloud has automatically been updated to include the new communication types.

19/04/2021

Setting Predefined Property Brochure Details

It is now possible to set or clear default property brochures when updating existing properties, using the PATCH method on /properties/{id}
Updating the ‘brochureId’ field on the ‘Selling’ and/or ‘Lettings’ models with a document ID, will set a PDF as the predefined property details. Please see an example in the Property Details screen from within AgencyCloud (Desktop CRM) below:

Inactive Webhooks

To ensure data viability and security, we have made a change to the way 'Sandbox only' Webhooks are handled.
Webhooks that have been setup specifically for Sandbox testing (SBOX) and have been unmodified for 14 days, will automatically be deactivated.
Should you wish to continue using Webhooks for Sandbox testing, you can reactivate it again by selecting the check box ‘Active’ when editing.

Large File Support

We have added additional support for uploading files over 6MB (Up to 30MB) to the Property Images and Documents endpoints via the use of pre-signed URL's

01/04/2021

Developer Portal and AppMarket Refresh

We are excited to announce today, the Developer Portal, Reapit AppMarket and AppMarket Apps UI have been updated in conjunction with the release of our Elements UI library version 2. The functionality of all apps remain the same but with UI enhancements to your user experience.
The visual changes you see are the first step towards a universal design language we have been working over the first part of the year. In the coming months you will see continued incremental updates as pages and flows are re-worked for better UI consistency, polish and UX. In keeping with our open source commitment, in the coming months we plan to make available publicly the design language, sample layouts and designs so that Reapit Developers can leverage our design resource to build better user experience into their own AppMarket apps.
Because we ask that all AppMarket Apps use our UI for visual consistency, we wanted to give the style guide a lift to ensure it best showcases of our development partner's work. This is the core of the Elements v2 release - it is a subtle evolution of the library, including a new font, typography, colour pallet, form inputs, notifications, dialogue boxes and much more.
Care has been taken to avoid breaking changes both to React Components and CSS Classes so that upgrading for all developers should be trivial and painless. We will also offer ongoing long term support in terms of security and bug fixes for the v2.x.x release. You can see the updates to the React Storybook here: https://elements.reapit.cloud/?path=/docs/
This however is just the start and we are now looking ahead to version 3 of Elements. Version 3 will be a ground up re-write of the library, both implementing fully the new design language and responding to both internal and external developer feedback. The version will focus on three core areas of improvement:
  • Visual UI refinement and consistency, fewer components and clearer design patterns to implement.
  • Better documentation for both React and non-React users, including suggested use cases and composed components for off-the-shelf UI / UX flows.
  • Much smaller library with very little required JavaScript and very few dependencies. Elements will be about the visual presentation with developers free to make their own choices as to how to implement behaviours. This will mean a far better developer experience, especially for non-React users and a much more flexible, less opinionated library.
For more information about the latest release and news about Elements 3.0 (coming soon) please click here.

09/03/2021

Configurable Webhook Behaviour

A new configuration option is now available when editing existing/creating new webhooks.
By default, webhooks will not be emitted when only the entity's eTag and modified timestamp has changed.
If you would prefer to receive notifications in this situation, please use the 'Ignore notifications where only the eTag has been modified' toggle option when configuring your webhook. See example below:
Adding a New Webhook
Existing webhooks will remain as they are and you can edit your webhooks at any stage from the 'Webhooks' page in the Developers Portal

New Developer Requests Documentation

To 'Request a Feature' or to 'Report a Bug' you can visit the 'Help' page in the Developers Portal. To help with understanding the process for each new issue raised, we have added a new section in our documentation 'Developer Requests'.
The new documentation will outline our processes, from what happens after submitting an issue to how your ticket will get triaged and categorised. Depending on the nature of the request or bug, it will determine which project board it may get assigned to. As our boards are public you will always be able to track the progress of any issue or request raised.
Help section in the Developers Portal

Virtual Viewing check box

With the very significant increase in the number of listings carrying virtual viewings, we have introduced an additional 'Virtual' check box on appointments inside of AgencyCloud:
The virtual field is also now available in our 'Appointments' API in the Platform:
"accompanied": true,
"virtual": false,
"negotiatorConfirmed": true,
"attendeeConfirmed": true,
"propertyConfirmed": true,
"metadata": {
"CustomField1": "CustomValue1",
"CustomField2": true
The latest version of the Developer Edition of AgencyCloud will include the new checkbox

25/02/21

With all enterprise customers now having access to the AppMarket, we wanted to use today’s What’s New update to highlight the features available to you on the ‘Analytics’ page in the Developers Portal.
The Analytics page provides useful information on the following:

Current Installations

A table to display the individual installations per client with a total number of installations per app

Hits Per Day

A graph showing the number of endpoints that are hit per day. You can also hover over a specific point for more information :

Installation Details

A full history of any installations or uninstallations that have occurred for your apps:

Transaction History

For a more granular level of information, you can download a month by month CSV of your transactions:

Services Chart

Any subscriptions or services you have subscribed to will be shown on the services chart and referenced by colour. Subscriptions/services may include, App Listings/Developer Edition of AgencyCloud/ Developer Registration etc:

Cost & Usage

You can use the ‘Cost Explorer: Cost & Usage’ section to view your current monthly subscription charges and navigate through previous months if required. We also provide a ‘Download’ option which will download this information in a CSV.

New section in the documentation

With an increase in apps now being submitted for approval, we have added a new section in our documentation ‘Listing an App’.
It covers, in detail, how to prepare your app before listing, what information is required, our testing processes and what happens when your app has been approved.

03/12/10

New fields now available

We have recently updated the Developers Portal to allow for 4 new fields on your App listing which can be managed when clicking on 'Edit Details'.
  • Terms and Conditions
  • Privacy Policy
  • Pricing Info
  • This Application is Free
For your App/Integrations to be submitted for approval and listed in the AppMarket, you will need to provide a secure URL (https://) for each field.
New fields on the 'Edit Details' app form
However, if your app is free of charge and occurs no cost to the end user, please use the ‘This Application is Free’ check box. If selected, you will not be required to enter your Pricing Information.
The information you provide in each field is then surfaced on your app listing in the AppMarket for agents to view:
Example of the new Developer Links section
If your app is ‘Free’, the pricing link will not be present on the app listing. A 'FREE' tag will be displayed when browsing the AppMarket:
'Free' App in the AppMarket
The URL you provide for your ‘Pricing Information’ will also be presented to an agent on the install confirmation modal.
If you have provided a URL we will display the following new section under 'Pricing Information':
Example 'Install' confirmation modal displaying a link to pricing

AgencyCloud Apps now launchable after installation

The latest release also includes a new ‘Launch App’ button after installation.
This will allow the agent to have the ability to immediately launch your App. This option is only available for AgencyCloud Apps (not available for ‘Integrations’)
New 'Launch App' button
As installations are only available to 'Admins', this is a great way to accelerate the onboarding process as it can be completed immediately.

Terminology Update

‘Direct API’ has now been updated to ‘Integration’. This has been updated in the Marketplace, Developers Portal and all associated documentation.

26/10/2020

Seamless integration between the Developer Portal & the Reapit AppMarket

Access between the AppMarket & the Developer Portal with one click! When you next log into the Developer Portal, you will see a new ‘Marketplace’ icon appear on the navigation. Clicking on the icon will take you to the Reapit AppMarket and automatically log you in using your Developer credentials.
To go back to the Developer Portal, simply click on the ‘Developers’ icon in the nav bar. The introduction of this flow will save time when testing and viewing your integration.

Full AppMarket View

Included in the new access flow, you will now see a full list of live and available apps, in addition to your own applications that are still in development. Previously, with your Developer account you could only see your own apps.
Apps that belong to your organisation and that are ‘In Development’ (not listed) will be clearly be shown with an ‘In Development’ banner, see example below:
The ‘In Development’ banner will be visible on the ‘Browse’ apps page, ‘Installed’ & ‘Managed’:

Third Party Installations

App installation remains the same and you still will only have the option to install apps that belong to your organisation. You can of course view apps that belong to third parties but the option to install will not be present.

Desktop API support for Emails & Websites

We are now supporting default mail client and browser loading for emails and external websites. If your AppMarket application presents an link to an email, you will need to update the mailto link to include the new AgencyCloud scheme ‘agencycloud://process/email?’
This will allow you to launch the users default email client and send to an address. An example would be:
agencycloud://process/[email protected]
This will create a new email in the user’s default mail client. It will do this by taking the value of the address parameter, prefixing it with mailto: and then starting a process with that argument.
Similar to the email link, using the scheme ‘agencycloud://process/webpage’ for a website page URL, will allow you to launch a webpage in the local default browser. An example would be:
agencycloud://process/webpage?url=https://www.reapit.com
This will launch the https://www.reapit.com site in the default browser. Note: the URL parameter must start with http for this to work.
For more information on the ‘Process’ scheme using the Desktop API, please click here

10/10/2020

It has been just over a month since we went into full production for the Foundations Developer Portal and since we officially launched the Reapit AppMarket.
We currently have the following apps live and available for agents that have access to the AppMarket to install.
Access to the AppMarket is dependent on the migration from our Rackspace environment to our AWS Infrastructure. The Migrations Team are still working hard on finalising the list of agents that will be part of Tranche 1. Once this has been confirmed we will share this information with our App Partners.
In addition to the apps that are publicly available, we also have several apps and integrations that are currently going through their final testing phase, most of which you will be able to see and follow on our coming soon section.
The coming soon section is visible on the AppMarket and provides agents the ability to click on any developer or company they are interested in to send an enquiry email.

Additional Testing

We have recently created a internal demo environment for us to be able help test and view your integrations using our office with the Customer ID ‘RES’. This new environment not only gives us the opportunity to see your integration or app in action, but it also allows you to further understand how the user flow is handled/presented outside of the sandbox installation.
If you wish to take part or setup a demo, you will need to list your app (tick the ‘is listed’ box on the app listing) and set 'Private App' to ‘Yes’ using Customer ID ‘RES’.
After submitting your revision, we will contact you directly to talk through the installation and what to expect.

Fixes and Changes

Over the last few weeks we have been working closely with our developers to see if we can look to improve or enhance the functionality on the Developers Portal, please see below what we’ve been working on.

Organisation & Billing

When you are ready to list your app, you will first need to complete your Organisation & Billing information. The Admin of your organisation will have access to this information from the ‘Settings’ page.
To complete your Organisation information, you will need to click on ‘Settings’ and select ‘Organisation’ You will then be required to fill in the following information:
  • Company Name
  • Telephone Number
  • Website Address
  • VAT/Company Reg and or National Insurance Number
  • About Us – The section will be displayed on any app listing in the AppMarket in addition to information about the app.
  • Company Address
Once completed, please then switch to the 'Billing' tab.
If you have an existing relationship with Reapit, you may already have a Reapit Reference. If so, simply enter your reference and submit. You can find your reference on any previous accounting correspondence.
We will then verify the reference and company information with our Accounts Department. This is normally completed the same day.
You will receive an email once your account has been set to ‘Confirmed’.
If you do not have a Reapit Reference, please then complete a Direct Debit mandate. It is an online form that will open in another tab. For those of you that have cookies disabled by default, and we know most developers do, you will need to enable them to complete the form. It’s an Adobe requirement, you can of course, disable as soon as you’ve signed the form.
Again, our Accounts Department will setup your account and you’ll receive an email with your new Reapit Reference. No need to do anything with the reference, as we will add this on your account automatically. Once received, you’ll be able to list your app or make any additional subscriptions.

Subscription fees suspended until 31st March 2021

Hopefully, you should have received an email from our Marketing team last week, which included the announcement of the following subscription fees suspended until March next year:
  • Annual Developer Registration
  • Developer Edition
  • App Listings
  • Reapit Connect
The idea and goal behind the suspension is that it should provide you a head start in the development of your app whilst the AppMarket and it’s users continue to grow.
In addition to this and quite exciting for us, Matt Goddard will now be leading our Reapit Partnership program. As the email quite rightly mentions, his knowledge and experience in the business will be an incredibly asset to you whilst you develop your integrations. Of course, our developers will still be available through Live Chat and I’ll be here to help if needed. Matt will be making contact with you in the coming weeks but if you have any questions, you can contact him here.

User Role Information

As you may be aware, only Reapit Admins have the ability to install or uninstall apps from the AppMarket. The Admins of an organisation are set by the individual office and are made aware of who has been assigned to the which role when they are migrated over to the new AWS infrastructure. However, to make it easier for you when speaking with Agents and for the users, we have introduced a ‘Role’ section within the AppMarket
.
When on the ‘Settings’ page – accessed by clicking on the company profile or group icon, will see a new field ‘Role’:
Those with a ‘Role’ set to ‘Admin’ or ‘Administrator’ will have the ability to install or uninstall apps.
Other changes we’ve been focusing on and something that will be coming soon.

28/08/20

What’s New with the Developers Portal?

Well, quite a lot actually! We are now in full production, which is a huge milestone for all of us. It does also mean with the new production environment, we have been able introduce quite a few new features.

Organisations

With the production environment in full effect, we now have the concept of organisations. Previously, if you were building or testing in the developers portal for the same company, you would have needed to share an account or setup additional users under a separate account. Now, you can setup your own organisation and invite members to join you.
This means you can collaboratively build and test your integrations under one account. It’s worth mentioning that only an ‘Admin’ will have the ability to view your organisation information.

Invite New Members

To invite members to join your organisation, simply click on the ‘Invite New Member’ button. The recipient will receive your invitation via email and will have the option to reject or accept. You can track the status of any members in the ‘Members’ table on the organisations tab:
Within the members section you will also have the ability to disable members and to set other members as ‘Admins’.

About your Organisation

The ‘About’ field is a text box provided for you to give a bit of information about your company. This will then be automatically included on your app listings and will be visible to users viewing your app in the AppMarket:

Account Information – Billing

Admins will also have access to setup and manage the account information for their organisation.
Account information will be required before an app can be listed in the AppMarket or before any subscriptions can commence.
If you are an existing customer of Reapit and already have an provided your account information, you can simply add your Reapit Reference (you will still need to submit some additional account information such as a contact name, email address etc). We will then send your information to our accounts department to be verified.
Once verified, your account status will be set to 'Confirmed' and you can continue with any subscriptions.
If you do have a Reapit Reference, you will be asked to complete an online Direct Debit mandate. Again, your information will be sent to our accounts department to be setup and once complete, you account status will be set to ‘Confirmed’ and you will automatically be provided with a unique Reapit Reference which we will add the billing page for you.
All subscriptions such as the annual App Listing fee, annual Developer registration & API Consumption Costs will then be added to your monthly Direct Debit. A break down of any subscription costs can be found on the ‘Cost Explorer’.

Description Field

We have now increased the character limit for the ‘Description’ field on your app listings. This will provide more room for additional formatting. The character limit has been set to 1,500. Remember, as the description field is using HTML, some special characters will count against the total, so we still advise on keeping the content as direct and concise as possible.

10/08/20

Reapit Foundations App Developer Experience

Over the Reapit Foundations public beta period, we have been working to improve the experience for AppMarket App Developers. Today we are announcing some significant updates to our front end tooling for web developers.

New Create React App template

Firstly we have released a new Create React App template to replace the scaffolder we demoed at the November launch. As before the template represents the quickest way to get started building AppMarket Apps, now with the added benefit of long term support, familiar CLI and stability from the React Scripts package.