Actions8
Overview
This node integrates with the Nimba SMS API to manage contacts, send SMS messages, handle campaigns, and track delivery reports. Specifically, for the Contact - Create operation, it allows users to add a new contact by providing a phone number along with optional additional details such as the contact's name and group memberships.
Common scenarios where this node is beneficial include:
- Building and maintaining a contact list for SMS marketing campaigns.
- Organizing contacts into groups for targeted messaging.
- Automating the addition of new contacts collected from forms or other sources.
Practical example:
- A marketing automation workflow that collects customer phone numbers and names from a web form and uses this node to create new contacts in the Nimba SMS system, optionally assigning them to specific groups for segmented campaigns.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The contact's phone number. Must be a valid phone number (e.g., +224123456789). |
| Additional Fields | Optional extra information about the contact: |
| - Name | The contact's name as a string. |
| - Groups | Comma-separated list of group names to assign the contact to (e.g., "Group1,Group2,Group3"). |
Output
The node outputs an array of JSON objects representing the created contact(s) as returned by the Nimba SMS API. Each object typically includes the contact's details such as the formatted phone number, name, assigned groups, and any metadata provided by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Nimba SMS API via an API key credential configured in n8n.
- The node depends on helper functions for phone number validation and formatting to ensure compliance with the API requirements.
- Network access to the Nimba SMS service endpoint is necessary.
Troubleshooting
- Invalid phone number error: If the phone number provided is not valid or improperly formatted, the node will throw an error indicating the invalid number. Ensure the phone number includes the country code and follows international format (e.g., +224123456789).
- API request failures: Network issues or incorrect API credentials can cause request failures. Verify that the API key credential is correctly set up and that the network connection to the Nimba SMS API is stable.
- Group assignment issues: When specifying groups, ensure the group names are comma-separated without extra spaces unless intended. Invalid group names may cause the API to reject the request.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.
Links and References
- Nimba SMS API Documentation (for detailed API usage and contact management)
- n8n Documentation (for general guidance on using credentials and nodes)