- Create entry
- Update entry
- Get entry
- List entries
Create entry
Create a new entry in your Contentful space.Required inputs- Contentful Account
- Space
- Environment
- Content Type
- Fields (dynamic based on content type schema)
- Locale (defaults to space’s default locale)
- Publish (publish immediately or save as draft)
Tip: Leave Publish unchecked to create drafts for review before publishing.
Supported field types
Profound adapts to your Contentful content model and supports all field types:Working with rich text
Rich text fields in Contentful use a structured document format called an abstract syntax tree (AST). Profound accepts Markdown, HTML, or Contentful’s native rich text JSON format. Supported Markdown:- Headings (
# H1through###### H6) - Paragraphs
- Bold, italic, and other formatting
- Bullet and numbered lists
- Blockquotes
- Code blocks
- Links
<h1>through<h6>headings<p>paragraphs<strong>,<em>,<u>formatting<ul>,<ol>,<li>lists<blockquote>blockquotes<code>,<pre>code blocks<a>links
Tip: Use whichever format is most convenient for your workflow.
Working with references
Reference fields link entries together. Provide either:- Single reference: Just the entry ID as a string
- Multiple references: An array of entry IDs
Understanding locales
Contentful uses a locale-based content model where every field value is keyed by locale (for example,en-US, fr-FR). Profound handles this automatically:
- Default behavior: If you don’t specify a locale, Profound uses your space’s default locale
- Single locale: Specify a locale to write content in that language
- Multi-locale: Use the raw JSON format to write multiple locales at once
How locale wrapping works
How locale wrapping works
When you provide a simple field value like:Profound automatically wraps it for Contentful’s API:Profound applies locale wrapping to all fields before submitting them to Contentful.
Input formats
Profound accepts two input formats for creating and updating entries:- Simple format
- Raw JSON format
The simple format is human-friendly and handles locale wrapping automatically:Features:
- Flat field structure (no locale nesting)
- Simple string IDs for references
- Markdown for rich text fields
- Automatic locale wrapping
Common use cases
- Content publishing: Generate and publish blog posts, articles, or product descriptions
- Content updates: Bulk update existing entries with new information
- Content migration: Move content between environments or spaces
- Automated Workflows: Create entries based on external triggers or data sources
Additional resources
Learn more about Contentful’s content model and API:- Contentful Content Model Concepts - Understanding spaces, environments, and content types
- Contentful Localization - How locales work in Contentful
- Rich Text Field Type - Understanding Contentful’s rich text format
- Content Management API - Full API reference