Connecting a Craft CMS site

Craft CMS sites connect through Craft's GraphQL API with an access token. Posts are saved as entries in one section and entry type. Because the platform expects specific field handles, prepare Craft first and involve the UP-TO-DATE support team for your first Craft site.

Before you start

• You are an Owner or Admin of the company in Accounts, or of its agency.

• You have administrator access to the Craft control panel.

• The site has a section for blog posts (for example with the handle blog) and an entry type in it (for example blogPost).

Step 1: Prepare the fields

The platform writes the post into these field handles on the entry type:

The title is always written to the entry title. New entries are saved as enabled, with author ID 1. These handles and the author can't be changed in the form, so make sure the entry type uses them, or ask the UP-TO-DATE support team before connecting.

Step 2: Create a GraphQL schema and token

1. In the Craft control panel, go to GraphQL.

2. Create a schema that can query entries in the blog section, and save and delete entries of the blog entry type.

3. Create a token assigned to that schema and copy it.

Step 3: Check the GraphQL addresses

The platform uses two addresses on the site:

• https://your-site.com/api for the connection test

• https://your-site.com/actions/graphql/api for publishing

Both must reach Craft's GraphQL API and accept the token.

Step 4: Open Connect a Site

1. In Accounts, go to Companies > open the company > Websites tab.

2. Click Connect a Site. If the company already has sites, click Connect New Site.

3. Under Select your CMS, choose Craft CMS.

Step 5: Fill in the fields

Step 6: Test the connection

1. Click Test Connection. It becomes clickable once the URL and token are filled in.

2. The test reads entries in the section, saves a disabled "Test Entry" and deletes it again.

3. When it passes, you see "Test connection successful! Token has required permissions."

Step 7: Connect and check

1. Click Connect. The site name is read from Craft.

2. Check that the site appears in the company's Websites list.

Important: If the site doesn't appear in the Websites list after you click Connect, don't connect it again. Contact the UP-TO-DATE support team so they can finish the connection.

Common errors

Related articles

• Connecting a website: the connection handler step by step

• Required technical access (before you start)

• Testing whether the connection works correctly

• Troubleshooting: website connections and crawls