Overview
This node integrates with the Taximail API to perform various messaging operations including sending emails, SMS, OTP (One-Time Password) via SMS, verifying OTP codes, and checking the status of sent messages. The "Check Status" operation specifically allows users to query the delivery or processing status of a previously sent message by providing its unique Message ID.
Common scenarios for this node include:
- Tracking the delivery status of transactional emails or SMS messages.
- Confirming whether an OTP sent to a user has been delivered or processed.
- Integrating message status checks into automated workflows for alerting or logging purposes.
For example, after sending an email or SMS through this node, you can use the "Check Status" operation with the returned Message ID to verify if the message was successfully delivered or if it encountered any issues.
Properties
| Name | Meaning |
|---|---|
| Message ID | The unique identifier of the message whose status you want to check. This ID is obtained from the response when sending an email, SMS, or OTP message. |
Output
The output JSON object contains the full response from the Taximail API regarding the status of the specified message. It includes fields such as delivery status, timestamps, and other metadata related to the message lifecycle.
Additionally, the output includes:
operation: The string"check_status"indicating the performed operation.message_id: The Message ID that was checked.
No binary data is produced by this operation.
Example output structure (simplified):
{
"operation": "check_status",
"message_id": "some_message_id",
"status": "...",
"details": { ... }
}
Dependencies
- Requires an API key credential for HTTP Basic Authentication to access the Taximail API.
- The node uses the Taximail REST API endpoints under
https://api.taximail.com/v2. - Proper configuration of credentials in n8n is necessary to authenticate requests.
Troubleshooting
- Missing or invalid Message ID: Ensure that the Message ID provided is correct and corresponds to a message previously sent via this node or the Taximail service.
- Authentication errors: Verify that the API key credentials are correctly set up and have sufficient permissions.
- Network or API errors: Check network connectivity and Taximail service status if requests fail.
- Unknown operation error: This should not occur if "check_status" is selected; if it does, confirm the operation parameter is correctly set.
If the node throws an error indicating "Operation failed", inspect the error message for details returned by the Taximail API and adjust inputs accordingly.
Links and References
- Taximail API Documentation (for detailed API usage and message status fields)
- n8n Documentation on Credentials (for setting up API authentication)