Description

n8n-nodes-textdotlk


This is an n8n community node package for the Text.lk service. It allows you to integrate Text.lk SMS functionality into your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Community Nodes (Recommended)

Follow the installation guide in the n8n community nodes documentation.

1. Go to Settings → Community Nodes
2. Select Install a community node
3. Enter n8n-nodes-textdotlk
4. Click Install

npm

To use this node in your n8n installation, you can install it via npm:

npm install n8n-nodes-textdotlk

Operations

SMS

• Send: Send an SMS message.
• Get: Retrieve details of a specific SMS.
• Get Many: Retrieve a list of SMS messages.

Contacts

• Create: Add a new contact to a group.
• Get: Retrieve details of a specific contact.
• Update: Update contact details.
• Delete: Remove a contact.
• Get Many: Retrieve a list of contacts.

Groups

• Create: Create a new contact group.
• Get: Retrieve details of a specific group.
• Update: Update a group’s name.
• Delete: Remove a group.
• Get Many: Retrieve a list of contact groups.

Profile

• View: View your profile details.

Credentials

You need a Text.lk API Access Token to use this node.

1. Log in to your Text.lk account.
2. Navigate to the API settings to generate an Access Token.
3. In n8n, add a new credential for Text.lk API.
4. Paste your Access Token.

Compatibility

• Tested against n8n version 1.0.0+.
• Docker smoke-tested with the current n8nio/n8n:latest image, including community-node installation, n8n startup, /healthz, and n8n export:nodes registration checks.
• Runtime metadata supports Node.js >=20.19 <25 to match current n8n community-node tooling and the latest n8n Docker image.
• Development and CI validation use Node.js 20 LTS or newer compatible with the n8n community-node tooling.

Usage

This node allows you to automate SMS sending and contact management using the Text.lk API. Ensure you have a valid API key and sufficient credit in your Text.lk account.

Package

• npm:
• Repository:

Security

• Store your Text.lk token only in n8n credentials.
• Do not hardcode tokens in workflows, exported workflow JSON, or repository files.
• Route identifier fields are constrained to route-safe alphanumeric values where n8n supports runtime field validation.
• SMS/contact fields include safer format guidance to avoid malformed API requests and accidental sensitive-data exposure.
• CI blocks critical production dependency advisories with npm run audit:prod. Current n8n upstream dependency trees can still report non-critical advisories; keep Dependabot enabled and review those updates as they become available.
• Open a GitHub issue for suspected package or node security issues. Do not include real tokens, customer phone numbers, or message contents in public reports.

Development

Prerequisites:

• Node.js 20 LTS or newer
• npm 10+

npm ci --ignore-scripts
npm run lint
npm run build
npx tsc --noEmit
npm run audit:prod
npm pack --dry-run

Use npm run validate:package for the standard local validation gate before publishing or opening a pull request.

To verify the published package in a real n8n container:

npm run smoke:n8n:docker

Optional overrides:

PACKAGEVERSION=0.1.4 HOSTPORT=5680 npm run smoke:n8n:docker

Resources

• n8n community nodes documentation
• Text.lk API Documentation

Version history

• 0.1.4: Add npm Trusted Publishing provenance, stricter CI validation, Docker-based n8n install/load smoke testing, package metadata hardening, and safer parameter guidance.
• 0.1.0: Initial release with SMS, Contact, Group, and Profile operations.

License

MIT