Skip to main content
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

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 TypeDescriptionInput Format
Short textSingle-line textPlain text
Long textMulti-line textPlain text
Rich textFormatted contentMarkdown (auto-converted)
NumberDecimal numbersNumber
IntegerWhole numbersInteger
BooleanTrue/falseBoolean
Date & timeISO 8601 datesDate string
LocationGeographic coordinates{lat, lon} object
JSON objectArbitrary JSONJSON object
MediaAsset referencesAsset ID
ReferenceEntry referencesEntry 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
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:
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

​
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: