Help Center
  • Welcome
  • Setka Editor
    • Getting started
    • Drag-and-Drop & Multiselect
    • Text editing
    • Grids and Layout
    • Images
      • Image Editor
    • Background images
    • Icons
    • Animations
    • Lists
    • Tables
    • Dividers
    • Footnotes
    • Hotspots
    • Enhance Symbols
    • Post templates
    • Buttons
    • Comments and collaboration
    • Embeds
    • Hyphenation
    • Responsive layout for mobile screens
    • Custom CSS
    • Custom JS plugins
  • Setka Content Design System Manager
    • Creating and editing styles
    • Text formats and fonts
    • Styles display for mobile mevices
    • Text and background colors
    • Dividers
    • Icons
    • Components – reusable design elements
      • Creating Components with HTML and CSS
        • CSS in components
        • Component examples
    • Configuring layout grids
    • Editing default elements with Custom CSS
    • Adding team members
  • Account Settings
    • Account settings basics
    • Access rights
    • Billing and subscription
  • Preserve your Setka Editor content after the service shutdown
  • Integrations
    • Setka and WordPress
      • Installing Setka Editor WordPress plugin
      • Launching Setka Editor on the post creation page
      • Setka Editor and WordPress compatibility
      • Setka Editor compatibility with the most popular WordPress plugins
      • Inserting graphs, charts, or diagrams into a post
      • Setka Editor and Google AMP
      • Inserting adverts into a post
      • srcset — the attribute for image size optimization
      • Page load speed optimization settings
        • Autoptimize plugin configuration
      • WordPress troubleshooting: known Issues and how to fix them
      • Preserve your Setka Editor content after the service shutdown
    • Setka and Drupal
      • Setka for Drupal — compatibility, and features
      • Installing Setka modules for Drupal
      • Setka content on AMP pages in Drupal
    • Setka and Magento
      • Installing Magento 2 extension
        • Setka Editor configuration page
      • Preserve your Setka Editor content after the service shutdown
    • Setka and HubSpot
      • Setka Editor and HubSpot Blogs
      • Setka Editor and HubSpot Landing Pages
      • Semi-gated content with a HubSpot form
      • Preserve your Setka Editor content after the service shutdown
    • Setka and Bitrix
      • Preserve your Setka Editor content after the service shutdown
    • Setka and Ghost
      • Copying and pasting posts from Setka to Ghost
    • Setka and SharePoint Online
      • Installing Setka Editor application into SharePoint Online
    • Setka and Zapier
      • Setka and Webflow
        • Exporting new posts
        • Updating exported posts
      • Setka and Shopify
    • Setka and Integromat
    • Content Cloud
  • API
    • Setka Content Cloud API
    • Webhooks
    • API for Custom CMS Integration
      • Introduction to custom integration
      • Integration with Content Design System Manager (CDSM)
        • Initial sync — receiving Setka Editor files to connect them to your CMS
        • Storing and processing Setka Editor files
        • Connecting Setka Editor files to the pages of your site
        • Receiving style updates from the Style Manager and new editor versions
      • Setka Post Editor initialization (JavaScript)
      • Integration with Style Manager (API v1, previous version)
      • Preserve your Setka Editor content after the service shutdown
    • Custom Components API
  • VIDEO TUTORIALS
    • Setka Editor Video Tutorials
  • Components Library
    • Components Library
    • Guide: Ideas for Using Setka Editor’s Components to Improve Content Design
  • Content Experience Design Best Practices
    • Guide To Designing a Great Content Experience
Powered by GitBook
On this page
  • Before you start
  • Receiving compressed files (.gz)
  • API Errors
  • Links that might be useful
  • More about custom integration:

Was this helpful?

  1. API
  2. API for Custom CMS Integration

Integration with Content Design System Manager (CDSM)

How to integrate your custom CMS with Setka Content Design System Manager.

PreviousIntroduction to custom integrationNextInitial sync — receiving Setka Editor files to connect them to your CMS

Last updated 4 years ago

Was this helpful?

Before you start

Before starting the integration, make sure that the Editor config URL field is specified in your (Integrations tab) for Setka Editor to work on your domain:

Editor config url is a link on which you will receive the latest version of the editor and updates for styles created in the Style Manager. On initial sync, you will also receive a public_token, which is required for several editor functions to work, e.g., for commenting and inserting embeds via a URL.

Please read about all the four steps to integrate Setka with your custom CMS via our API:

Receiving compressed files (.gz)

In all the above-mentioned methods, you receive links to uncompressed resources. You can receive compressed versions from CDN by identifying an Accept-Encoding heading in a request.

E.g.:

curl -H 'Accept-Encoding: gzip' https://ceditor.setka.io/editor.v.1.2.3.min.js

API Errors

Errors that Setka Editor API may return:

HTTP/1.1 401 Unauthorized

{
  "error": "Not authorized!"
}

The error occurs as a result of a request with an incorrect license key (token).

HTTP/1.1 422 Unprocessable Entity

{
  "errors": {
    "code": ["can't be blank"],
    "name": ["can't be blank"]
  }
}

The error appears as a result of an incorrect request.

Links that might be useful

  • Master domain for requests acceptance and resources recipient: https://editor.setka.io.

More about custom integration:

Requests to editor.setka.io should contain your license key (hereinafter, in request samples, it is marked as your-license-key). You can get the license key on your account's CMS Integration page in

Step 1:

Step 2:

Step 3:

Step 4:

You can contact our with any errors. We will be glad to help!

your account:
Initial sync. Receiving Setka Editor files to connect them to your CMS
Storing and processing Setka Editor files
Connecting Setka Editor files to the pages of your site
Receiving style updates from the Content Design System Manager and new editor versions
support team
The latest version of API documentation
Ruby on Rails integration example
Introduction to Custom Integration
Setka Post Editor initialization (JavaScript)
Setka Account
Screenshot of Setka Interface: "CMS Integrations" tab, step 1 - "Set your domain" other integration
Screenshot of Setka Editor Interface: "CMS Integration" tab with "Get License Key" field