RD Station Marketing icon

RD Station Marketing

Consume RD Station Marketing API
Join our community

Actions5

Overview

This node integrates with the RD Station Marketing API to manage contacts. Specifically, the "Contact - Get Many" operation retrieves multiple contacts from a specified segmentation (a group or list of contacts). It supports fetching either all contacts in that segmentation or a limited number based on user preference.

Common scenarios where this node is useful include:

  • Exporting or syncing contact lists from RD Station Marketing for further processing.
  • Automating marketing workflows by retrieving segmented contacts dynamically.
  • Reporting or analytics tasks that require bulk access to contact data within specific segments.

For example, you might use this node to fetch all contacts tagged as "Newsletter Subscribers" and then send them personalized emails through another system.

Properties

Name Meaning
Sgmentation Name or ID The segmentation (contact group) from which to retrieve contacts. Choose from a list or specify an ID.
Return All Whether to return all contacts in the segmentation (true) or limit the number of results (false).
Limit Maximum number of contacts to return if "Return All" is set to false. Minimum value is 1.

Output

The output is an array of JSON objects, each representing a contact retrieved from the specified segmentation. Each contact object contains the contact's details as provided by the RD Station Marketing API.

  • The output does not include binary data.
  • Each item in the output corresponds to one contact.
  • The structure of each contact JSON matches the RD Station Marketing contact schema, including fields like email, name, tags, custom fields, etc.

Example snippet of output JSON for one contact (simplified):

{
  "email": "example@example.com",
  "name": "John Doe",
  "tags": ["subscriber", "lead"],
  "custom_fields": {
    "field_identifier": "value"
  }
}

Dependencies

  • Requires an API authentication credential for RD Station Marketing (OAuth2 or API key).
  • Uses RD Station Marketing REST API endpoints to fetch segmentations and contacts.
  • The node relies on internal helper functions to handle API requests and pagination.

Troubleshooting

  • Missing or invalid segmentation ID: If the segmentation ID or name is incorrect or missing, the API call will fail. Ensure the segmentation exists and is correctly selected.
  • API rate limits or connectivity issues: Network problems or hitting API rate limits may cause errors. Check your network connection and RD Station API usage quotas.
  • Empty results: If no contacts are returned, verify that the segmentation actually contains contacts.
  • Limit vs Return All conflict: Setting "Return All" to false but specifying a very high limit may still result in partial data due to API constraints.

Common error messages:

  • "Email is required to get a contact by email" or "UUID is required to get a contact by UUID" — these appear in other operations but not in "Get Many".
  • General HTTP errors from the API will be passed through; check the error message for details.

To resolve errors:

  • Double-check input parameters.
  • Verify API credentials and permissions.
  • Consult RD Station Marketing API documentation for endpoint-specific requirements.

Links and References

Discussion