PortaOne icon

PortaOne

Consume PortaOne API (v.1.0.24)

Overview

This n8n node allows you to add a new Customer Extension in the PortaOne system by interacting with its API. It is designed for scenarios where you need to automate the creation of customer extension records, such as provisioning telephony services, managing user extensions, or integrating customer data between systems. For example, you might use this node to automatically create a new extension when onboarding a new customer or to synchronize extension data from another CRM.

Properties

Name Meaning
Authentication The authentication method to use. Options: Token Authentication, Basic Authentication.
ID The subject's ID. (Required)
AdditionalFields A collection of optional fields to further specify the extension:
- Account ID: The unique ID of the account record.
- CPE ID
- Customer ID: The unique ID of the customer record.
- Product ID
- Name: The subject's name
- Port: The CPE device port that will be used by the defined or created account
- Prompt Action: The name of action to perform with the prompt
- Published: Indicates whether the extension is accessible via dial-by-name
Simplify Whether to simplify the output data. (true/false)
SimplifyPath Path to the property that should be returned if simplification is enabled.

Output

  • The node outputs a json object containing the result of the "Add Customer Extension" operation.
  • If "Simplify" is enabled, only the specified property (via "SimplifyPath") or a simplified structure will be returned.
  • If not simplified, the full response from the PortaOne API for the created extension is provided.
  • No binary data is produced by this operation.

Dependencies

  • Requires access to the PortaOne API.
  • Needs either a valid Token or Basic Authentication credentials configured in n8n:
    • portaOneTokenApi credential for Token Authentication
    • portaOneBasicApi credential for Basic Authentication

Troubleshooting

  • Authentication Errors:
    • Error Message: "Invalid credentials" or "401 Unauthorized"
      Resolution: Ensure the correct authentication method and credentials are set up in n8n.
  • Missing Required Fields:
    • Error Message: "ID is required" or similar
      Resolution: Make sure the "ID" field is filled in.
  • API Connection Issues:
    • Error Message: "Network error" or "Failed to connect"
      Resolution: Check network connectivity and ensure the PortaOne API endpoint is reachable.
  • Invalid Field Values:
    • Error Message: "Invalid value for field ..."
      Resolution: Double-check the values provided in "AdditionalFields" for correctness and type.

Links and References

Discussion