RD Station Marketing icon

RD Station Marketing

Consume RD Station Marketing API

Actions5

Overview

This node integrates with the RD Station Marketing API to manage contacts within the marketing platform. Specifically, the Contact - Create operation allows users to create new contact records by providing an email and optional additional information such as name, phone numbers, social profiles, tags, and custom fields.

Common scenarios for this node include:

  • Adding new leads collected from web forms or other sources into RD Station Marketing.
  • Enriching contact data by including detailed profile information at creation time.
  • Automating lead generation workflows by programmatically creating contacts based on external triggers.

For example, a marketing automation workflow could use this node to add a new contact when a user signs up on a website, including their email, full name, job title, and social media links.

Properties

Name Meaning
Email The contact's email address (required).
Additional Fields A collection of optional fields to enrich the contact record:
- Bio Notes about the contact.
- Birthday Date Contact's birthdate in date-time format.
- City City where the contact is located.
- Country Country of the contact.
- Custom Fields Allows setting custom fields not predefined in the node. Users can select from existing custom field names or specify IDs and provide corresponding values.
- Facebook URL to the contact's Facebook profile.
- Job Title Contact's job position or title (e.g., CEO).
- Linkedin URL to the contact's LinkedIn profile.
- Mobile Phone Contact's mobile phone number in international format.
- Name Full name of the contact.
- Phone Contact's personal phone number in international format.
- State State or region where the contact resides.
- Tags Comma-separated list of tags to assign to the contact.
- Twitter URL to the contact's Twitter (X) profile.
- Website URL to the contact's personal or company website.

Output

The node outputs JSON objects representing the created contact as returned by the RD Station Marketing API. The output includes all contact details stored in the platform after creation.

  • The json output contains the contact data fields such as email, name, phone numbers, social links, tags, and any custom fields set.
  • There is no binary data output for this operation.

Example output snippet (simplified):

{
  "email": "name@email.com",
  "name": "John Doe",
  "job_title": "CEO",
  "tags": "lead,newsletter",
  "custom_fields": {
    "field_id_or_name": "value"
  }
}

Dependencies

  • Requires an API authentication credential configured in n8n to connect to RD Station Marketing.
  • Uses the RD Station Marketing REST API endpoints for contacts.
  • No additional external dependencies beyond the API access.

Troubleshooting

  • Missing required email: The node requires an email address to create a contact. If omitted, it will throw an error.
  • API authentication errors: Ensure the API key or OAuth2 credentials are valid and have sufficient permissions.
  • Invalid custom field names or IDs: When specifying custom fields, ensure the field names or IDs exist in RD Station; otherwise, the API may reject the request.
  • Network or API downtime: Temporary connectivity issues or RD Station API outages can cause failures; retry or check service status.

Common error messages:

  • "Email is required" — Provide a valid email address.
  • "Invalid credentials" — Verify API authentication setup.
  • "Field not found" — Check custom field names/IDs.

Links and References

Discussion