datocms

Package Information

Released: 7/9/2025

Downloads: 0 weekly / 0 monthly

Latest Version: 1.0.1

Author: pherzig

Available Nodes

DatoCMS

Interact with DatoCMS API

Documentation

n8n-nodes-datocms

This is an n8n community node that provides a simplified interface for DatoCMS operations. It lets you automate content management tasks in DatoCMS using n8n workflows.

n8n is a fair-code licensed workflow automation platform.

DatoCMS is a headless CMS for modern web and mobile applications.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm

npm install n8n-nodes-datocms

n8n Community Nodes GUI

Go to Settings > Community Nodes
Select Install
Enter n8n-nodes-datocms in Enter npm package name
Select Install

Operations

Records

Create - Create a new content record
Create or Update - Create or update a record based on matching fields (upsert)
Delete - Delete a record
Get - Retrieve a single record
Get Many - List records with advanced filtering
Update - Update an existing record
Publish - Publish a draft record
Unpublish - Unpublish a live record

Uploads

Create - Upload a file from binary data or URL
Bulk Create - Upload multiple files from URLs with automatic asset reference replacement
Delete - Delete an uploaded file
Get - Get upload information
Get Many - List uploads with optional collection filtering

Item Types

Get - Get details of a specific content model
Get Many - List all available content models

Features

Dynamic Field Loading

Content types and fields are automatically loaded from your DatoCMS project
No need to manually enter IDs or field names

ResourceMapper Integration

Visual field mapping interface for easy configuration
Support for required, unique, and localized fields
Automatic field validation based on DatoCMS schema

Advanced Filtering

Filter records by any field value
Support for multiple operators (equals, greater than, in, exists, etc.)
Works with both system fields and custom fields

Bulk Operations

Upload multiple files at once from URLs
Automatic URL extraction from data structures
Replace URLs with DatoCMS asset references for seamless integration

Error Handling

Comprehensive error messages
Continue on fail support for batch operations
Detailed operation statistics for bulk uploads

Credentials

To use this node, you need to create DatoCMS API credentials:

Log in to your DatoCMS project
Go to Settings > API Tokens
Create a new API token with appropriate permissions
In n8n, create new DatoCMS credentials using this token

Credential Fields

API Token - Your DatoCMS management API token
Environment - The environment to use (default: main)
Base URL - The DatoCMS API endpoint (default: https://site-api.datocms.com)

Usage Examples

Creating a Record

Select Resource: Record
Select Operation: Create
Choose your Item Type from the dropdown
Map fields using the visual ResourceMapper
Enable Auto Publish if needed

Filtering Records

Select Resource: Record
Select Operation: Get Many
Choose your Item Type
Add filters to search for specific records:
- Select field (e.g., "status", "created_at")
- Choose operator (e.g., "equals", "greater than")
- Enter value

Bulk Upload Images

Select Resource: Upload
Select Operation: Bulk Create
Configure source (input data or URL list)
Enable Replace URLs in Data to get asset references
The output will include DatoCMS asset references ready for record creation

Upsert Records (Sync External Data)

Select Resource: Record
Select Operation: Create or Update
Choose your Item Type
In ResourceMapper, select matching fields (e.g., external_id, SKU)
Map all other fields
Enable Create If Not Found to create new records when no match exists