SMSNiaga icon

SMSNiaga

Consume SMSNiaga API for SMS messaging

Actions9

Sender ID → Update

AI-generated

Overview

This node integrates with the SMSNiaga API to manage SMS sender identifiers (Sender IDs). Specifically, the "Update" operation for the "Sender ID" resource allows users to modify an existing sender identifier's details such as its name, description, and whether it is set as the default sender ID.

Use cases include:

  • Renaming a sender ID to reflect a new company or brand name.
  • Updating the description to provide better context or notes about the sender ID.
  • Changing which sender ID is the default for sending SMS messages.

Practical example:

  • A marketing team wants to update their SMS sender ID from "OldBrand" to "NewBrand" and mark it as the default sender ID for all outgoing SMS campaigns.

Properties

Name Meaning
Select to Update Sender ID Name or ID (senderIdUuid) Choose the specific sender ID to update by selecting from a list loaded dynamically or specifying an ID via expression. This identifies which sender ID record will be modified.
Name of Sender ID Name (senderIdName) The new or updated name for the sender identifier. Typically a unique name like a company or brand name.
Description (description) Optional text describing the sender ID to help identify it.
Is Default (isDefault) Boolean flag indicating if this sender ID should be set as the default for SMS messages. If no default exists, one will be assigned automatically.

Output

The node outputs JSON data representing the updated sender identifier returned from the SMSNiaga API. This typically includes fields such as the sender ID's UUID, name, description, default status, and other metadata provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active SMSNiaga API key credential configured in n8n to authenticate requests.
  • The node makes HTTP requests to the SMSNiaga API endpoint at https://manage.smsniaga.com/api.
  • The user must have appropriate permissions on the SMSNiaga account to update sender identifiers.

Troubleshooting

Common issues and error messages:

  • Authentication failed: Invalid or expired API token. Solution: Verify and update the API credentials in n8n.
  • Validation error: The API could not process the request due to invalid parameters (e.g., missing required fields or invalid values). Solution: Check that all required properties are correctly filled and formatted.
  • Bad request: Improperly formatted request or invalid parameters. Solution: Review input property values and ensure they meet API requirements.
  • Forbidden: Insufficient permissions to update sender IDs. Solution: Confirm the API key has necessary access rights.
  • Not found: The specified sender ID does not exist. Solution: Ensure the correct sender ID UUID is selected.
  • Rate limit exceeded: Too many requests sent in a short time. Solution: Slow down request frequency.
  • Server error: Issue on SMSNiaga server side. Solution: Retry later or contact SMSNiaga support.

If the node is set to continue on failure, errors will be returned as JSON objects containing error details instead of stopping execution.

Links and References

Discussion