PortaOneInstall

Overview

This n8n node allows you to assign a DID (Direct Inward Dialing) number to a master account in the PortaOne system. It is designed for users who manage telephony resources and need to automate the assignment of phone numbers to specific accounts within their PortaOne environment.

Common scenarios:

• Automating onboarding processes by assigning new phone numbers to customer accounts.
• Bulk operations where multiple DID numbers need to be programmatically assigned to different accounts.
• Integrating with CRM or provisioning systems to streamline telecom resource management.

Practical example:
A telecom provider uses this node in an n8n workflow to automatically assign available DID numbers to new customers as soon as they sign up, ensuring immediate service activation.

Properties

Output

• By default, the node outputs a json object containing the result of the assignment operation from the PortaOne API.
• If "Simplify" is enabled, the output will be reduced to only the specified property (as per "SimplifyPath"), making it easier to extract relevant information.
• No binary data is produced by this node.

Dependencies

• External Services: Requires access to a PortaOne instance with API enabled.
• API Credentials: You must provide either a PortaOne API token or basic authentication credentials, depending on the selected authentication method.
• n8n Configuration: Ensure the appropriate credentials are set up in n8n under "portaOneTokenApi" or "portaOneBasicApi".

Troubleshooting

Common issues:

• Invalid Credentials: If the provided API token or username/password is incorrect, authentication will fail. Double-check your credentials.
• Missing Required Fields: Both "DID Number ID" and "Master Account ID" are required. Omitting these will result in errors.
• Permission Errors: The authenticated user must have permission to assign DID numbers in PortaOne.
• Incorrect SimplifyPath: If "Simplify" is enabled but "SimplifyPath" does not match any property in the response, the output may be empty or throw an error.

Error messages and resolutions:

• "Authentication failed" – Check your API credentials and ensure the correct authentication method is selected.
• "Required parameter missing" – Make sure all required properties are filled in.
• "Resource not found" – Verify that the provided DID Number ID and Master Account ID exist in your PortaOne system.

Links and References

• PortaOne Official Documentation
• n8n Documentation: Creating Custom Nodes
• DID Numbers - Wikipedia