We have moved!

You are currently looking at documentation for Umbraco 8 and older versions.
Go to docs.umbraco.com for documentation for Umbraco 9 and newer versions.

    Umbraco Heartcore

    In this section you will find documentation on how to work with Umbraco Heartcore.

    It includes REST API documentation, the basics on how to get started and how to work with the available Client Libraries. Please note that Umbraco Heartcore is a specific type of project only available via Umbraco Cloud.

    API Documentation for the Umbraco Heartcore REST API endpoints

    Reference documentation for the APIs available, as well as details about common HTTP headers, versioning, REST Standard and how to work with authentication and authorization.


    Reference documentation and tutorials for the GraphQL API.


    What is Umbraco Heartcore?

    Umbraco Heartcore is a headless SaaS (Software as a Service) offered by Umbraco. The service enables you to create and manage content and media in the Umbraco backoffice and make it available to any - and multiple - platforms, devices, channels etc. in order to distribute your content.

    The product comes with a set of API endpoints that enables you to provide content through Umbraco to websites, apps, smartwatches or any other platform you can think of. The idea is that you create, manage and work with content in the Umbraco backoffice and then you use the API endpoints to distribute the content wherever you want.

    All Umbraco Heartcore projects includes a Content Delivery Network (CDN) using CloudFlare. This CDN is used for caching content and media fetched through the Content Delivery API. Additionally, the media CDN (media.umbraco.io) allows for resizing and cropping options, which improves both performance and stability.

    You can read more about all the features and benefits on the Umbraco Heartcore product page.

    There are 3 ways to get your hands on an Umbraco Heartcore project:

    Getting Started with Umbraco Heartcore

    In order to get started with Umbraco Heartcore you will need to create a new project via the Umbraco Cloud Portal and familiarize yourself with the features available. This includes the Headless section in the backoffice and creating API Keys for authentication and authorization purposes.

    In this article you will learn how to create your first Umbraco Heartcore project and go through the steps needed to get your first content published in order to start using the APIs.

    Setup a Trial project

    Client libraries

    In order to test your Umbraco Heartcore project against the REST API endpoints, you can use one of the samples we provide with the client libraries for .NET Core and Node JS.

    Versions and updates

    Learn more about how we handle versioning and updates of Heartcore projects.

    Frequently asked questions

    Do you have questions that are not covered by this documentation? Please create an issue on our Documentation Issue Tracker or get in touch with Umbraco Support using the chat in the portal or write a mail to [email protected]