Publishing integration
Publish to Umbraco
Creates and publishes content via Umbraco's Management API (v13+). Least battle-tested integration here -- verify property alias names and payload shape against your version.
How it works
Connects through Umbraco's Management API (v13+) using OAuth2 client-credentials.
Before you start
- Umbraco 13 or later
- An OAuth2 client (client ID and secret) with Management API access, configured in Umbraco's backoffice
- The document type and property alias names you want posts mapped to
Setup
Three steps to connect
Step 1
Get your client secret
Umbraco backoffice -> Users -> API access, or a configured OAuth client for the Management API.
Step 2
Enter your site details
- Site URL *
- Content type alias *Settings -> Document Types -> open the target type -> the alias is shown next to its display name.
- Parent content ID *The content node new posts should be created under (e.g. the blog listing page) -- Content section -> select that node -> Info tab shows its ID.
- Body property aliasThe property alias on your content type that holds the post body -- check its Design tab.
- Excerpt property alias
- Client ID
Step 3
Connect and publish
Once connected, approved posts publish straight to Umbraco automatically. No export, no import, no copy-pasting into a CMS. Setup runs from your own client portal, so credentials for Umbraco stay with you; the agency never has to hold or request them separately.
Troubleshooting
If something doesn’t connect
Connection test fails at the token step
The client credentials need to be issued specifically for the Management API, not the older Content Delivery API, which uses a different auth model entirely.
Posts are created but properties are empty
Property alias names are project-specific. Double-check them against your document type in the backoffice before relying on the default mapping.
Frequently asked questions
Umbraco 13 and later, since that's when the Management API used here shipped.
It's the newest integration here. Worth a test post first, and property alias names should be double-checked against your Umbraco version.
No, they're created and published in the same call, unless your setup has a custom publish workflow attached to that document type.
Credentials are encrypted at rest and only ever used server-side to publish. Nobody, including us, can view them again once saved.
Nothing changes on Umbraco itself. Everything already published stays exactly as it is. New posts just stop syncing until it's reconnected.
Still have questions? Talk to our team.
Ready to connect Umbraco?
Book a call and we'll get your site's publishing integration set up together.