Connect Drupal

Drupal is the one CMS integration that uses an account username and password rather than a token, because that is what Drupal's basic authentication provides.

Available on every plan.

What you Need

• The JSON:API module enabled.
• The HTTP Basic Authentication module enabled.
• JSON:API write operations allowed.
• A Drupal account that can create article content.

Step 1: Enable the Modules

Enable both:

• JSON:API
• HTTP Basic Authentication

Step 2: Allow Write Operations

Open Configuration → JSON:API and allow write operations.

JSON:API defaults to read-only. Without this change the connection can read your site and cannot create anything, which produces a connection that verifies against nothing useful.

Step 3: Enter the Credentials

1. Open Sidebar → Integrations.
2. Find Drupal under Publishing & CMS.
3. Fill in the three fields:

1. Select Connect Drupal.

The password is sent over HTTPS only.

Step 4: Verify

Select Verify connection. On success you see "Drupal connection verified."

On failure: "Could not verify the Drupal connection. Check the site URL, username, and password."

A Note on Using a Password

This integration stores account credentials rather than a revocable token, which is how Drupal's basic authentication works.

Two sensible precautions:

Create a dedicated account for NarraSEO rather than using your own administrator login. Give it permission to create article content and nothing more.

Use HTTPS. Basic authentication over plain HTTP exposes the credentials in transit. NarraSEO sends over HTTPS only, so make sure your site is served that way.

Publishing Options

Drupal uses Draft, Publish now, and Schedule, with a Publish date and time field, plus the Featured image and Article title toggles.

If it Will Not Connect

Write operations are not allowed. Check Configuration → JSON:API. This is the most common cause.

HTTP Basic Authentication is not enabled. Without it, the credentials cannot be used.

The account lacks permission. It needs to create article content. Check the role's permissions.

You added the JSON:API path. Enter the site address only.

Your site blocks basic authentication. Some hosting configurations and security modules strip the authorization header.

Notes

Changing the account's password in Drupal breaks the connection until you update it here.

Articles are created under the account whose credentials you used.

The connection is per project.

Drupal content rendering depends on your text format and theme. Check that your text format permits the HTML tags NarraSEO articles use, particularly headings, lists, and tables.