RD Station Marketing community node for n8n

This is a community node for n8n that enables integration with the RD Station Marketing API.

Features

• OAuth2 Authentication with automatic token refresh
• Contact Management: Create, update, and retrieve contacts
• Events: Register standard conversion events
• Segmentations: List segmentations and their contacts
• Error Handling: Clear messages and robust error handling
• Validation: Automatic input data validation

Installation

Via npm

npm install n8n-nodes-rdstation-marketing

Via n8n Community Nodes

1. Open your n8n settings
2. Navigate to "Community Nodes"
3. Install n8n-nodes-rdstation-marketing

Configuration

1. Create an Application in RD Station

1. Go to the RD Station App Store
2. Create a new application
3. Configure the callback URLs:
   • For development: http://localhost:5678/rest/oauth2-credential/callback
   • For production: https://your-n8n-domain.com/rest/oauth2-credential/callback
4. Copy the Client ID and Client Secret

2. Configure Credentials in n8n

1. In n8n, go to "Credentials"
2. Create a new "RD Station Marketing OAuth2 API" credential
3. Enter the Client ID and Client Secret from the previous step
4. Click "Connect my account" and authorize access

Usage

Contacts

Create or Update a Contact

{
  "email": "[email protected]",
  "name": "John Doe",
  "job_title": "Developer",
  "mobile_phone": "+5511999999999",
  "city": "São Paulo",
  "state": "SP",
  "country": "Brazil",
  "tags": "lead,interested,developer"
}

Retrieve a Contact

• By email: [email protected]
• By UUID: 12345678-1234-1234-1234-123456789012

List Contacts from a Segmentation

• Option to return all contacts or limit the number of results
• Automatic pagination for large volumes

Resources

Contacts

• ✅ Create contact
• ✅ Update contact
• ✅ Get contact by email
• ✅ Get contact by UUID

Events

• ✅ Register standard conversion event

Segmentations

• ✅ List segmentations
• ✅ List contacts from a segmentation

Error Handling

The node includes robust error handling for the RD Station Marketing API:

• Validation Errors: Clear messages about invalid data
• Authentication Errors: Automatic token renewal
• Rate Limit Errors: Information about API limits
• Connection Errors: Network failure handling

Development

Set Up the Development Environment

# Clone the repository
git clone https://github.com/olivasdigital/n8n-nodes-rdstation-marketing.git
cd n8n-nodes-rdstation-marketing

# Install dependencies
npm install

# Build
npm run build

# Run lint checks
npm run lint

# Auto-fix lint issues
npm run lintfix

Project Structure

├── credentials/
│   └── RdStationMarketingOAuth2Api.credentials.ts
├── nodes/
│   └── RdStationMarketing/
│       ├── RdStationMarketing.node.ts
│       ├── GenericFunctions.ts
│       └── rdstation.svg
├── dist/                    # Generated after build
├── package.json
├── tsconfig.json
└── README.md

Testing Locally

# Link for local testing
npm link

# In the n8n directory
npm link n8n-nodes-rdstation-marketing

# Restart n8n

Contributing

Contributions are welcome! Please:

1. Fork the project
2. Create a branch for your feature (git checkout -b feat/new-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feat/new-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License — see the LICENSE file for details.

Support

• 📖 RD Station Marketing API Documentation
• 🐛 Report Issues
• 💬 Discussions

Changelog

v1.0.3

• Updated deprecated requestWithAuthentication to httpRequestWithAuthentication
• Translated all UI strings, error messages, and descriptions from Portuguese to English

v1.0.2

• ✅ Register standard conversion event
• ✅ List contacts from a segmentation
• Improved API error message capture

v1.0.1

• Build fix

v1.0.0

• ✅ OAuth2 authentication with RD Station Marketing
• ✅ Get contact
• ✅ Create contact
• ✅ Update contact