Overview
This node acts as a trigger that starts an n8n workflow when specific events occur in the MFR system. It listens for webhook callbacks related to various event types such as new appointments, new companies, new service objects, new service requests, and changes in service request states. This is useful for automating workflows based on real-time updates from the MFR platform.
Practical examples include:
- Automatically processing or notifying teams when a new appointment is created.
- Syncing company data when a new company is added.
- Triggering follow-up actions when a service request changes state.
Properties
| Name | Meaning |
|---|---|
| WebHookType | The type of event to listen for. Options: New Appointment, New Company, New Service Object, New Service Request, Service Request State Changed. |
| External ID | An optional string to filter webhooks by an external identifier associated with the event. |
Output
The node outputs the JSON payload received from the webhook call under the json field. This payload contains the event data sent by the MFR system corresponding to the selected webhook type and optional external ID filter.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the MFR API.
- The node uses the MFR API to manage webhook registrations (create, check existence, delete).
- The workflow must be accessible via a public URL to receive webhook callbacks.
Troubleshooting
- Webhook registration failure: If the node cannot create or find the webhook on the MFR side, ensure the API key credential is valid and has sufficient permissions.
- No workflow trigger on events: Verify that the webhook URL is publicly accessible and correctly registered in the MFR system.
- Invalid or missing event data: Check that the selected WebHookType matches the events being sent by MFR and that the optional External ID filter is correct.
- API errors during webhook deletion: These are caught silently but may indicate permission issues or that the webhook was already removed.
Links and References
- MFR API documentation (for webhook management and event types) – typically provided by the MFR platform.
- n8n webhook documentation: https://docs.n8n.io/nodes/n8n-nodes-base.webhook/