PlainInstall

Overview

This node integrates with the Plain API to manage various resources such as companies, customers, threads, events, labels, and tenants. Specifically for the Customer resource with the Delete operation, it allows users to delete a customer by their unique customer ID.

Common scenarios where this node is beneficial include:

• Automating customer lifecycle management workflows.
• Removing obsolete or incorrect customer records from the system.
• Integrating customer deletion into larger automation pipelines that maintain data hygiene.

For example, you might use this node in an automation that triggers when a customer unsubscribes or requests account deletion, ensuring their data is removed from the Plain system automatically.

Properties

Name	Meaning
Customer ID	The unique identifier of the customer to delete. This is a required string input.

Output

The output JSON object after a successful delete operation contains:

• success: A boolean indicating whether the deletion was successful (true).

If the deletion fails, the node throws an error with a descriptive message.

No binary data output is produced by this operation.

Example output on success:

{
  "success": true
}

Dependencies

• Requires an active connection to the Plain API via an API key credential configured in n8n.
• The node uses GraphQL mutations to perform operations on the Plain API.
• Proper permissions are needed on the API key to delete customers.

Troubleshooting

Common Issues

• Missing or invalid Customer ID: The node requires a valid customer ID to delete a customer. Ensure the ID is correct and exists in the Plain system.
• API permission errors: If the API key lacks delete permissions, the node will throw an authorization error.
• Network or connectivity issues: Failures to reach the Plain API endpoint will cause errors.

Error Messages and Resolutions

• "Customer identifier is required": This means the customer ID parameter was not provided or is empty. Provide a valid customer ID.
• Errors returned from the Plain API mutation (e.g., "error.message"): These indicate issues reported by the API, such as trying to delete a non-existent customer. Review the error message for details.
• "Unknown error": Generic fallback error; check network connectivity and API credentials.

To resolve errors, verify input parameters, ensure API credentials have proper permissions, and confirm network access to the Plain API.

Links and References

• Plain API Documentation (hypothetical link)
• GraphQL Mutation Reference
• n8n documentation on Creating Custom Nodes

---

This summary focuses exclusively on the Customer - Delete operation as requested.