SMSNiaga icon

SMSNiaga

Consume SMSNiaga API for SMS messaging

Actions9

Group → Create

AI-generated

Overview

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 - Create operation, it allows users to create a new subscriber group associated with their SMSNiaga account. This is useful for organizing contacts into groups for targeted SMS campaigns or management.

Practical examples include:

  • Creating a new subscriber group named "Promotions" to send marketing messages.
  • Organizing contacts by region or interest to streamline message targeting.

Properties

Name Meaning
Group Name The name of the subscriber group to create. This is a required string input where you specify the desired group name.

Output

The output is a JSON object representing the newly created subscriber group as returned by the SMSNiaga API. It typically includes details such as the group's unique identifier (UUID), name, creation timestamp, and other metadata provided by the API.

If an error occurs during the creation process, the node outputs an error object containing:

  • error: A descriptive error message.
  • statusCode: HTTP status code from the API response.
  • timestamp: Time when the error occurred.
  • resource: The resource type ("group").
  • operation: The operation attempted ("create").

No binary data is produced by this operation.

Dependencies

  • Requires an active SMSNiaga API key credential configured in n8n.
  • The node makes HTTP requests to the SMSNiaga API endpoint at https://manage.smsniaga.com/api.
  • Proper network connectivity to the SMSNiaga service is necessary.

Troubleshooting

  • Authentication failed: If the API token is invalid or expired, the node will throw an authentication error. Ensure your API credentials are correct and up to date.
  • Validation errors: Occur if the group name is missing or improperly formatted. Make sure to provide a valid, non-empty group name.
  • Rate limiting: Excessive requests may trigger rate limit errors. Implement delays or reduce request frequency if needed.
  • API server errors: Temporary issues on the SMSNiaga side may cause 5xx errors. Retry after some time.
  • Not found or forbidden errors: Usually indicate incorrect permissions or resource identifiers; verify your account permissions and parameters.

Links and References

Discussion