Using Contentful in Agents

After connecting your Contentful account, the following actions become available as Agent steps. Each step requires you to select a connected Contentful Account from a dropdown.

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)

Optional inputs

Locale (defaults to space’s default locale)
Publish (publish immediately or save as draft)

The entry is created based on your content type’s schema. Rich text fields accept Markdown which is automatically converted to Contentful’s rich text format.

Tip: Leave Publish unchecked to create drafts for review before publishing.

Supported Field Types

Contentful’s dynamic schema means Profound automatically adapts to your content model. All field types are supported:

Field Type	Description	Input Format
Short text	Single-line text	Plain text
Long text	Multi-line text	Plain text
Rich text	Formatted content	Markdown (auto-converted)
Number	Decimal numbers	Number
Integer	Whole numbers	Integer
Boolean	True/false	Boolean
Date & time	ISO 8601 dates	Date string
Location	Geographic coordinates	`{lat, lon}` object
JSON object	Arbitrary JSON	JSON object
Media	Asset references	Asset ID
Reference	Entry references	Entry ID or array of IDs

Working with Rich Text

Rich text fields in Contentful use a structured document format (AST). Profound accepts Markdown, HTML, or Contentful’s native rich text JSON format. Supported Markdown:

Headings (# H1 through ###### H6)
Paragraphs
Bold, italic, and other formatting
Bullet and numbered lists
Blockquotes
Code blocks
Links

Supported HTML:

<h1> through <h6> headings
<p> paragraphs
<strong>, <em>, <u> formatting
<ul>, <ol>, <li> lists
<blockquote> blockquotes
<code>, <pre> code blocks
<a> links

Native Rich Text JSON: If you already have Contentful rich text documents, you can pass them directly:

{
  "nodeType": "document",
  "data": {},
  "content": [
    {
      "nodeType": "paragraph",
      "data": {},
      "content": [
        { "nodeType": "text", "value": "Hello world", "marks": [] }
      ]
    }
  ]
}

Tip: Use whichever format is most convenient for your workflow. Markdown, HTML, and native rich text JSON all work seamlessly.

Working with References

Reference fields link entries together. You can provide:

Single reference: Just the entry ID as a string
Multiple references: An array of entry IDs

Profound automatically compiles these into Contentful’s required link format.

Understanding Locales

Contentful uses a locale-based content model where every field value is keyed by locale (e.g., 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

When you provide a simple field value like:

{
  "title": "My Blog Post"
}

Profound automatically wraps it for Contentful’s API:

{
  "title": {
    "en-US": "My Blog Post"
  }
}

This locale wrapping happens for all fields before submission 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:

{
  "space": "your-space-id",
  "environment": "master",
  "content_type_id": "blogPost",
  "locale": "en-US",
  "fields": {
    "title": "My Blog Post",
    "body": "# Hello\n\nThis is **markdown**.",
    "heroImage": "asset-123",
    "relatedPosts": ["post-1", "post-2"]
  },
  "publish": false
}

Features:

Flat field structure (no locale nesting)
Simple string IDs for references
Markdown for rich text fields
Automatic locale wrapping

The raw format gives you full control over locale-specific content:

{
  "space": "your-space-id",
  "environment": "master",
  "content_type_id": "blogPost",
  "fields": {
    "title": {
      "en-US": "My Blog Post",
      "fr-FR": "Mon Article de Blog"
    },
    "body": {
      "en-US": "# Hello\n\nEnglish content.",
      "fr-FR": "# Bonjour\n\nContenu français."
    }
  },
  "publish": false
}

Use this format when:

Writing content in multiple locales simultaneously
You need precise control over locale-specific values
Migrating content from another system

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

Contentful

Drupal

Framer

G2

Gamma

Gong

Looker

Sanity

Wordpress

Using Contentful in Agents

Create Entry

Update Entry

Get Entry

List Entries

Supported Field Types

Working with Rich Text

Working with References

Understanding Locales

Input Formats

Common Use Cases

Additional Resources

​Create Entry

​Update Entry

​Get Entry

​List Entries

​Supported Field Types

​Working with Rich Text

​Working with References

​Understanding Locales

​Input Formats

​Common Use Cases

​Additional Resources

Create Entry

Update Entry

Get Entry

List Entries

Supported Field Types

Working with Rich Text

Working with References

Understanding Locales

Input Formats

Common Use Cases

Additional Resources