Plain icon

Plain

Interact with Plain API

Event → Create

AI-generated

Overview

This node integrates with the Plain API to manage customer events. Specifically, the Event - Create operation allows users to create a new event associated with a specified customer. This is useful in scenarios where you want to log or track activities, appointments, or any notable occurrences related to a customer within your workflow automation.

For example, after a customer interaction or support ticket resolution, you might want to automatically create an event record summarizing the interaction. This node facilitates that by letting you specify the customer and event details, which then get recorded in the Plain system.

Properties

Name Meaning
Customer ID The unique identifier of the customer for whom the event will be created.
Title The title or name of the event being created.
Additional Fields Optional extra information about the event:
- Description A textual description providing more details about the event.
- External ID An optional external identifier for the event, useful for cross-referencing or syncing.

Output

The output JSON contains the newly created event's data with the following key fields:

  • id: The unique identifier of the created event.
  • title: The title of the event as provided.
  • createdAt.iso8601: The timestamp when the event was created, in ISO 8601 format.

If the creation fails, an error message is thrown describing the issue.

No binary data is produced by this node.

Dependencies

  • Requires an active connection to the Plain API via an API key credential configured in n8n.
  • The node uses GraphQL mutations to communicate with the Plain API.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Error: "Unknown error" or specific error messages from the API
    This usually indicates invalid input data or missing required fields. Ensure that the Customer ID and Title are correctly provided and valid in the Plain system.

  • Field errors in the response
    If the API returns field-specific errors (e.g., invalid Customer ID), the node throws an error listing these fields. Verify the correctness of all input parameters.

  • API connectivity issues
    Check that the API key credential is valid and has sufficient permissions to create events.

  • Empty or missing Customer ID
    Since Customer ID is required, omitting it will cause the node to fail. Always provide a valid Customer ID.

Links and References


This summary covers the logic and usage of the Event Create operation in the Plain node based on static code analysis.

Discussion