← All integration guides

Send RecordJoy Video Events to Zoho CRM with n8n

When you finish this guide, every RecordJoy event will upsert a Zoho CRM contact by email and attach a note with the video link and watch count.

flowchart LR
    A[RecordJoy] -->|"event JSON"| B["n8n Webhook node"]
    B --> C["Zoho: upsert contact"]
    C --> D["Zoho: attach note"]
    D --> E[(Zoho CRM)]

Shortcut: RecordJoy ships an importable version — docs/recipes/n8n-zoho.json. The steps below build the same thing by hand.

Prerequisites

• An n8n instance reachable over HTTPS
• A Zoho CRM account; n8n's Zoho OAuth2 API credential will walk you through creating a client in the Zoho API console (api-console.zoho.com → Server-based Applications)
• RecordJoy account (any plan)

Estimated time

25 minutes

Steps

Part A — the webhook

1. In n8n, click + Add workflow and name it RecordJoy → Zoho.
2. Add a Webhook node: HTTP Method POST, Path recordjoy-zoho.
3. Click Save, then switch the Active toggle on.
4. Open the Webhook node and copy the Production URL.

🖥️ What you should see: a URL like https://your-instance.app.n8n.cloud/webhook/recordjoy-zoho.

5. In recordjoy.ai → dashboard sidebar → CRM Integration: paste the URL, tick your events, click Save, then Send test event.
6. In n8n's Executions tab, confirm an execution arrived with "event": "recording.test" under body.

Part B — upsert the contact

7. Add an HTTP Request node connected to the Webhook node; name it Upsert Contact.
8. Configure:
   • Method: POST
   • URL: https://www.zohoapis.com/crm/v5/Contacts/upsert (use zohoapis.eu / zohoapis.in if your Zoho account lives in that data center)
   • Authentication: Predefined Credential Type → Zoho OAuth2 API (create the credential and complete the sign-in)
   • Body Content Type: JSON, Specify Body: Using JSON
9. Paste this as the JSON body:

={{ { "data": [ { "Last_Name": $json.body.recording.sentTo || $json.body.recording.createdBy, "Email": $json.body.recording.sentTo || $json.body.recording.createdBy } ], "duplicate_check_fields": [ "Email" ] } }}

Contact rule: this maps sentTo with a createdBy fallback. For inbound recording.received events use sentBy instead.

10. Execute the step and confirm the output contains data[0].details.id.

🖥️ What you should see: a response with code: SUCCESS and a long numeric id under data[0].details.id.

Part C — attach the note

11. Add another HTTP Request node connected to Upsert Contact; name it Attach Note. Same Zoho OAuth2 credential.
12. Configure: Method POST, URL https://www.zohoapis.com/crm/v5/Notes, Body JSON:

={{ { "data": [ { "Note_Title": "RecordJoy " + $('Webhook').item.json.body.event, "Note_Content": ($('Webhook').item.json.body.recording.description || "") + " — watch: " + $('Webhook').item.json.body.recording.viewUrl + " (watched " + ($('Webhook').item.json.body.recording.watchedTimes || 0) + "x)", "Parent_Id": $json.data[0].details.id, "se_module": "Contacts" } ] } }}

13. Click Save and confirm the workflow is Active.

Verification

14. In RecordJoy → CRM Integration, click Send test event.
15. In n8n Executions, confirm a green run through all three nodes.
16. In Zoho CRM → Contacts, open the contact matching your account email and scroll to Notes.

🖥️ What you should see: a note titled RecordJoy recording.test with a recordjoy.ai/view/... link.

Troubleshooting