Overview
This node integrates with RD Station CRM to manage contacts. Specifically, the "Contato" resource with the "Criar" operation allows users to create new contact records in their RD Station CRM account. It is useful for automating the addition of new leads or customer contacts from various sources into the CRM system.
Typical use cases include:
- Automatically adding new leads captured from web forms or marketing campaigns.
- Syncing contact data from other systems into RD Station CRM.
- Enriching CRM contacts with detailed information such as emails, phone numbers, social profiles, and custom fields.
For example, a marketing automation workflow could use this node to create a contact whenever a new subscriber signs up, including their name, email addresses, phone numbers, and legal consent bases.
Properties
| Name | Meaning |
|---|---|
| Nome | The contact's full name. This is mandatory and must have at least 2 characters. |
| Dados do Contato | A collection of additional contact details: - Nome (only for update) - Cargo (job title) - Aniversário (birthday in yyyy-mm-dd format) - ID da Organização (organization ID the contact belongs to) - IDs das Negociações (deal IDs separated by commas) - Facebook profile URL - LinkedIn profile URL - Skype username |
| E-mails | Multiple email entries can be added, each with: - E-mail address (required) - Tipo (type): Personal, Commercial, Other - Principal (boolean to mark as primary email) |
| Telefones | Multiple phone entries can be added, each with: - Número (phone number, required) - Tipo (type): Mobile, Home, Work, Fax |
| Campos Customizados | Custom fields for the contact, each with: - ID do Campo (custom field ID) - Valor (value for the custom field) |
| Base Legal | Legal bases for data processing, each with: - ID da Base Legal (legal base ID) - Categoria (category of the legal base) |
Output
The node outputs JSON data representing the created contact as returned by the RD Station CRM API. The output includes all contact details stored in the CRM after creation, such as assigned IDs, timestamps, and any enriched data.
No binary data output is produced by this node.
Example output structure (simplified):
{
"id": "contact_id",
"name": "Contact Name",
"emails": [
{
"email": "example@example.com",
"type": "personal",
"primary": true
}
],
"phones": [
{
"phone": "+5511999999999",
"type": "mobile"
}
],
"organization_id": "org_id",
"deal_ids": ["deal1", "deal2"],
"facebook": "https://facebook.com/profile",
"linkedin": "https://linkedin.com/in/profile",
"skype": "skype_user",
"contact_custom_fields": [
{
"custom_field_id": "field_id",
"value": "custom value"
}
],
"legal_bases": [
{
"id": "legal_base_id",
"category": "category_name"
}
]
}
Dependencies
- Requires an API key credential for RD Station CRM authentication configured in n8n.
- Uses the RD Station CRM REST API endpoint
https://crm.rdstation.com/api/v1/contacts. - The node depends on proper network connectivity to RD Station CRM services.
Troubleshooting
Error: "Nome do contato é obrigatório e deve ter no mínimo 2 caracteres!"
This error occurs if the "Nome" property is missing or too short. Ensure the contact name is provided and has at least 2 characters.Error: "ID do contato é obrigatório!" (for update operations)
When updating a contact, the contact ID must be specified. Make sure to provide a valid contact ID.API Authentication Errors
If the node fails due to authentication issues, verify that the API key credential is correctly set up and has sufficient permissions.Network or API Errors
Temporary network failures or API rate limits may cause errors. Check your internet connection and RD Station CRM API usage limits.Invalid Data Format
Date fields like birthday must be in the correct ISO date format (yyyy-mm-dd). Invalid formats may cause request failures.