Description

!Banner image

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": "contact@example.com",
  "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: contact@example.com
• 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