Overview
This node manages webhooks in the RD Station CRM platform, specifically allowing users to create, update, retrieve, list, and delete webhooks. Webhooks are used to receive real-time notifications from RD Station CRM when certain events occur, such as creation or updates of deals, contacts, or tasks.
A common use case is automating workflows by triggering actions in other systems whenever a specified event happens in RD Station CRM. For example, you can create a webhook that notifies your application when a new deal is created, enabling instant processing or analytics.
The "Create" operation for the "Webhook" resource allows you to register a new webhook with specific callback URL, events to listen for, status, data format, and custom HTTP headers.
Properties
| Name | Meaning |
|---|---|
| Dados do Webhook | Collection of fields defining the webhook to create: |
| - URL de Callback | The callback URL where notifications will be sent when the selected events occur (required). |
| - Eventos | List of events that will trigger the webhook notification. Options include: |
| - Negócio Criado (deal.created) | |
| - Negócio Atualizado (deal.updated) | |
| - Contato Criado (contact.created) | |
| - Contato Atualizado (contact.updated) | |
| - Tarefa Criada (task.created) | |
| - Tarefa Atualizada (task.updated) | |
| - Status | Status of the webhook: "Ativo" (active) sends notifications; "Inativo" (inactive) does not. Default is active. |
| - Formato de Entrega | Format of the data sent to the callback URL: "JSON" or "XML". Default is JSON. |
| - Cabeçalhos HTTP | Custom HTTP headers to send along with the webhook request. Multiple name-value pairs can be added. |
Output
The output is a JSON object representing the response from the RD Station CRM API after creating the webhook. It typically contains details about the newly created webhook, such as its ID, URL, subscribed events, status, and other metadata.
If the operation fails, the output will contain an error message describing the issue.
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the RD Station CRM API.
- The node makes HTTP requests to
https://crm.rdstation.com/api/v1/webhooks. - Proper network connectivity to RD Station CRM's API endpoint is necessary.
Troubleshooting
Missing Required Fields:
Errors like "É necessário fornecer uma URL de callback para o webhook!" or "É necessário selecionar pelo menos um evento para acionar o webhook!" indicate missing required inputs. Ensure the callback URL and at least one event are provided.Invalid Webhook ID:
When updating or deleting, if the webhook ID is missing or invalid, errors will prompt you to provide a valid ID.Empty Update Data:
Attempting to update a webhook without specifying any fields to change will result in an error asking for at least one field to update.API Authentication Issues:
If authentication fails, verify that the API key credential is correctly configured and has sufficient permissions.Network or API Errors:
Network issues or API downtime may cause request failures. Check connectivity and RD Station CRM service status.
Links and References
- RD Station CRM API Documentation - Webhooks (official API docs for webhook management)
- n8n Documentation (for general usage of n8n nodes and credentials)