diff --git a/docs/_images/integrations/credentials/cal/getting-api-key.gif b/docs/_images/integrations/credentials/cal/getting-api-key.gif new file mode 100644 index 00000000000..92c6b65a6ed Binary files /dev/null and b/docs/_images/integrations/credentials/cal/getting-api-key.gif differ diff --git a/docs/_images/integrations/trigger-nodes/caltrigger/workflow.png b/docs/_images/integrations/trigger-nodes/caltrigger/workflow.png new file mode 100644 index 00000000000..e4c3ba6717d Binary files /dev/null and b/docs/_images/integrations/trigger-nodes/caltrigger/workflow.png differ diff --git a/docs/integrations/credentials/cal.md b/docs/integrations/credentials/cal.md new file mode 100644 index 00000000000..4147a102e2f --- /dev/null +++ b/docs/integrations/credentials/cal.md @@ -0,0 +1,21 @@ +# Cal + +You can use these credentials to authenticate the following nodes with Cal. + +- [Cal Trigger](/integrations/trigger-nodes/n8n-nodes-base.calTrigger/) + +## Prerequisites + +Create a [Cal](https://www.cal.com/) pro account. + +## Using API keys + +Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error. + +1. Log into your Cal account. +2. Click on **Settings**. +3. There you will find the API keys section which allows you to generate a key for use. More information on this can be found on the [Cal Authentication](https://developer.cal.com/api/authentication){:target=_blank} page. +4. Use API key in your Cal trigger node credentials in n8n. + + +![Getting Cal credentials](/_images/integrations/credentials/cal/getting-api-key.gif) diff --git a/docs/integrations/trigger-nodes/n8n-nodes-base.calTrigger.md b/docs/integrations/trigger-nodes/n8n-nodes-base.calTrigger.md new file mode 100644 index 00000000000..cec6561470a --- /dev/null +++ b/docs/integrations/trigger-nodes/n8n-nodes-base.calTrigger.md @@ -0,0 +1,33 @@ +# Cal Trigger + +[Cal](https://cal.com/) is the event-juggling scheduler for everyone. Focus on meeting, not making meetings. + +!!! note "Credentials" + You can find authentication information for this node [here](/integrations/credentials/cal/). + + + +## Example Usage + +This workflow allows you to receive updates for events in Cal. + +- [Cal Trigger]() + +The final workflow should look like the following image. + +![A workflow with the Cal Trigger node](/_images/integrations/trigger-nodes/caltrigger/workflow.png) + + +### 1. Cal Trigger node + +1. First of all, you'll have to enter credentials for the Cal Trigger node. You can find out how to do that [here](/integrations/credentials/cal/). +2. Select the events you want to receive updates for from the **Events** dropdown list. +3. Click on **Execute Node** to run the node. + +(Optional Advanced Settings) + +Click on **Add Field** under advanced fields and select the option(s) you wish to add. You can enter an EventType ID, an App ID and a payload template. Note that the eventType ID must be of a team EventType. + +!!! note "Activate workflow for production" + You'll need to save the workflow and then click on the Activate toggle on the top right of the screen to activate the workflow. Your workflow will then be triggered as specified by the settings in the Cal Trigger node. +