PortaOne icon

PortaOne

Consume PortaOne API (v.1.0.24)
Join our community

Actions34

Overview

The PortaOne node for n8n allows you to interact with the PortaOne API. Specifically, when using the Customer resource and the Delete operation, this node deletes a customer record from your PortaOne system. This is useful in scenarios where you need to automate customer lifecycle management, such as removing customers who have canceled their service or are no longer active.

Practical examples:

  • Automatically delete customer records when they unsubscribe from your platform.
  • Integrate with CRM systems to keep customer data synchronized by removing obsolete entries.
  • Batch process customer deletions based on business rules.

Properties

Name Meaning
Authentication The authentication method to use. Options: Token Authentication, Basic Authentication.
Customer ID The unique ID of the customer record to be deleted.
Simplify Whether to simplify the output data.
SimplifyPath Path to the property that should be returned (used if simplifying output).

Output

  • The node outputs a json field containing the result of the delete operation.
  • If Simplify is enabled, only the specified part of the response (as defined by SimplifyPath) will be returned.
  • Otherwise, the full API response related to the deletion request is provided.
  • Binary data: This operation does not output binary data.

Dependencies

  • External Services: Requires access to a PortaOne instance with API enabled.
  • API Credentials: You must provide either a Token or Basic Authentication credentials via n8n's credential system:
    • portaOneTokenApi for Token Authentication
    • portaOneBasicApi for Basic Authentication
  • n8n Configuration: Ensure the appropriate credentials are set up in n8n under the node's credential options.

Troubleshooting

  • Invalid Credentials:
    Error message: "Authentication failed" or similar.
    Resolution: Check that the correct authentication method and valid credentials are provided in n8n.

  • Missing Customer ID:
    Error message: "Customer ID is required" or similar.
    Resolution: Ensure the Customer ID property is filled with a valid numeric value.

  • Insufficient Permissions:
    Error message: "Not authorized" or "Permission denied".
    Resolution: Make sure the user associated with the credentials has permission to delete customers in PortaOne.

  • Incorrect SimplifyPath:
    Error message: "Property not found at path" or empty output.
    Resolution: Double-check the path entered in SimplifyPath matches the structure of the API response.

Links and References

Discussion