Changelog

[1.2.0-beta] - 2025-07-11 🚀📈

🌟 Leads lifecycle improvements
Manage your lead configurations with with mutation insertLeadConfiguration and query leadConfigurations.
We added a explicit way to turn a lead into a patient mutation createPatientFromLead.
See all of it in the API reference Leads section.
🌟 External mapping management
We added to fields to manage your external mappings: mutation setExternalMapping and query externalMappingByKeyValue.
The metadata you store on the external mapping, as well as the key/value pair used to find a Greyfinch resource ID depend on your app externalMappings definitions. For details and usage patterns, see the External Mappings Guide.

API queries and mutations normalization
We cleaned up and normalized queries, mutations, and data types in our API in an effort to make our API more intuitive and robust going forward. We may have some more minor changes coming up but the biggest refactor is done and we don't expect many breaking changes going forward. Thanks for your feedback and
The most notable changes are:
- All insert<X> mutations now take an object argument, e.g.: insertAppointment(patientId: uuid!, locationId: uuid!, appointmentTypeId: uuid!) is now insertAppointment(object: { patientId: uuid!, locationId: uuid!, appointmentTypeId: uuid! }). Mutations that represent more specific actions such as scheduleAppointment kept their arguments at the top-level.
- All IDs are now expected to be UUIDs. Get Greyfich Resource IDs through query externalMappingByKeyValue if needed.
- query appointmentAvailability response changed to be a flat list of {date: string, start_time: string, end_time: string}[].

We removed most of the unstable<X> queries and mutations after they lived side-by-side with their stable counterparts, which are now fully replaced by the unprefixed actions, eg unstableScheduleAppointment is now scheduleAppointment. The implementation details remain the same.

🌟 Schedule Appointments, Create Leads, Save Images, Insert Orders
Our API has been enhanced with new features designed to streamline your development workflow. You can now Schedule Appointments, allowing for seamless integration of booking functionality within your applications. The Create Leads endpoint helps you manage potential customers more effectively by automating lead generation. With the Save Images feature, you can easily store patient images. Finally, the Insert Orders functionality offers a way to inform GF of orders and their statuses. Dive into a walk through of the steps necessary to Book an Appointment here 🎩✨

🌟 Introducing Greyfinch Connect Public API v1.0 Beta!
Dive into a new era of connectivity with our latest API offering. Unleash the potential of Greyfinch by integrating your applications seamlessly. Expect the unexpected – more power, more flexibility, and a touch of magic! More information here 🎩✨
-Why you should care: Our API provides robust tools for developers looking to enhance application capabilities with Greyfinch data. -Documentation: Start building with Greyfinch here. -Feedback: Your insights drive our improvements. Share your thoughts via our feedback portal.

🚧 Remember, it's a beta! While we've worked hard to squash bugs 🐛, expect some adventures along the way. We will likely change data types and field names as we move to 1.0. If you have any suggestions, please join us on this journey and help shape the future of Greyfinch Connect!

Was this helpful?