Skip to main content
After connecting your Drupal account, the following nodes become available in Profound Agents. The nodes work with Drupal’s JSON:API module. Content is accessed by a resource type (the entity type, such as Basic, Image, or Article) and by a resource UUID.

Available nodes

Create Item

Create a new item of a resource type.

Required inputs

  • Drupal Site — Select a site from the dropdown
  • Resource type — The JSON:API resource type, such as node--article
  • Attributes or Relationships (or both) — A JSON object of field values or references to other resources.
A request with neither Attributes nor Relationships is rejected, include at least one.

Key concepts

Resource types

Resource types follow Drupal’s JSON:API naming convention: the entity type and bundle joined by two hyphens.
Resource typeDescription
node--articleArticle content type nodes
node--pageBasic page nodes
taxonomy_term--tagsTags taxonomy terms
Use List Items to discover available resource types and inspect the structure of items returned for your Drupal site.

Resource UUIDs

Items are referenced by UUID. When you create or list items, use the UUID from the JSON:API response as the Resource UUID in later steps.

Attributes and relationships

Create Item and Update Item require at least one of Attributes or Relationships.
  • Attributes — Field values for the item, such as title, body, or status. Example attributes for a node--article:
    {
      "title": "My new article",
      "body": {
        "value": "<p>Article content here.</p>",
        "format": "basic_html"
      },
      "status": true
    }
    
  • Relationships — References to other resources, such as taxonomy terms, authors, or related nodes. Example relationships linking tags to an article:
    {
      "field_tags": {
        "data": [
          { "type": "taxonomy_term--tags",
            "id": "9b2c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e"
          }
        ]
      }
    }
    

Additional resources