Actions9
Group → Delete
AI-generatedOverview
This node integrates with the SMSNiaga API to manage SMS messaging and related resources such as subscriber groups, sender IDs, and account information. Specifically, for the Group - Delete operation, it allows users to delete a subscriber group associated with their SMSNiaga account by specifying the group's unique identifier.
This operation is useful when you want to clean up or remove outdated or unused subscriber groups from your SMS marketing or communication lists. For example, if a campaign has ended or a group is no longer relevant, deleting the group helps maintain an organized list of active subscribers.
Properties
| Name | Meaning |
|---|---|
| Select Group Name or ID | Choose the subscriber group to delete by selecting from a dynamically loaded list of groups or by specifying the group's unique ID using an expression. This property is required. |
Output
The output of this node operation is a JSON object representing the response from the SMSNiaga API after attempting to delete the specified subscriber group. Typically, this will include confirmation of deletion or details about the deleted group.
If the deletion is successful, the output JSON may contain metadata about the deleted group or a success message. If there is an error (e.g., group not found), the node will throw an error unless configured to continue on failure, in which case the output will include an error object with details such as the error message, HTTP status code, timestamp, resource, and operation.
The node does not output binary data for this operation.
Dependencies
- Requires an active SMSNiaga API key credential configured in n8n.
- The node makes authenticated HTTP requests to the SMSNiaga API endpoint at
https://manage.smsniaga.com/api. - The user must have appropriate permissions to delete subscriber groups in their SMSNiaga account.
Troubleshooting
- Authentication failed: If the API token is invalid or expired, the node will return an authentication error. Ensure that the API key credential is correctly set up and valid.
- Not found error: If the specified group UUID does not exist, the API will return a 404 error. Verify that the group ID is correct and currently exists.
- Forbidden error: Lack of permission to delete groups will result in a 403 error. Check user permissions in the SMSNiaga account.
- Rate limit exceeded: Sending too many requests in a short time may cause a 429 error. Implement delays or reduce request frequency.
- Validation errors: Improperly formatted group IDs or missing required parameters will cause validation errors (422). Ensure the group UUID is provided and correctly formatted.
- If "Continue On Fail" is enabled, errors will be returned as part of the output JSON instead of stopping execution.
Links and References
- SMSNiaga API Documentation (for detailed API endpoints and usage)
- n8n Expressions Documentation (for using expressions to specify dynamic values)