Actions20
Overview
This node integrates with the Linq API to manage webhook subscriptions among other resources. Specifically, for the Webhook Subscription - Create operation, it allows users to create a new webhook subscription by specifying the target webhook URL, events to subscribe to, version, and activation status.
This is useful in scenarios where you want to receive real-time notifications or callbacks from the Linq platform about specific events (e.g., chat updates, message reactions). For example, you might create a webhook subscription to get notified whenever a new chat message arrives or when a contact is updated, enabling automated workflows triggered by these events.
Properties
| Name | Meaning |
|---|---|
| Webhook URL | The URL endpoint where webhook notifications will be sent. |
| Events | Comma-separated list of event names to subscribe to (e.g., "message.created,message.deleted"). |
| Version | The version number of the webhook API to use (default is 2). |
| Active | Boolean flag indicating whether the webhook subscription should be active immediately. |
Output
The node outputs the JSON response returned by the Linq API after creating the webhook subscription. This typically includes details such as the subscription ID, webhook URL, subscribed events, version, active status, creation timestamp, and possibly other metadata related to the subscription.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Linq API.
- The node makes HTTP requests to
https://api.linqapp.com/api/partner/v2/webhook_subscriptions. - Ensure that the API key has permissions to create webhook subscriptions.
- No additional environment variables are required beyond the API key credential.
Troubleshooting
- Rate Limit Exceeded: If the node throws an error stating "Rate limit exceeded. Please try again after 10 seconds.", it means too many requests were made in a short period. To resolve, wait at least 10 seconds before retrying.
- Invalid Webhook URL: Providing an invalid or unreachable webhook URL may cause the API to reject the subscription. Verify the URL is correct and publicly accessible.
- Incorrect Event Names: Supplying event names not supported by the Linq API may result in errors or no notifications. Confirm the event names are valid and correctly comma-separated.
- Authentication Errors: If authentication fails, check that the API key credential is correctly configured and has necessary permissions.
Links and References
- Linq API Documentation (Assumed official docs URL; replace with actual if known)
- Webhook Subscriptions API Reference (Replace with actual link if available)