Connect Secure icon

Connect Secure

Consume Connect Secure API

Actions222

Overview

This node allows you to create an "Event Set" by sending a JSON payload to an external API. It is useful in scenarios where you need to programmatically define or update event sets, such as configuring alert rules or managing default event configurations within a system that supports event sets.

For example, you might use this node to automate the creation of monitoring event sets with specific alert rules for different users or environments.

Properties

Name Meaning
X USER ID The user identifier required for authentication or scoping the request.
Data A JSON object representing the event set details to be created. Typically includes fields like alert_rules (an array) and is_default (a boolean).

The Data property expects a JSON string that will be parsed and sent as the body of the request.

Example of Data value:

{
  "alert_rules": [],
  "is_default": false
}

Output

The node outputs the response from the API call in the json field of the output data. This typically contains the details of the newly created event set, including any identifiers or status information returned by the API.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the external Connect Secure API.
  • The node depends on the external Connect Secure API service being available.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Missing or invalid X USER ID: If the user ID header is missing or incorrect, the API may reject the request. Ensure the X USER ID property is correctly set.
  • Malformed JSON in Data: The Data property must be valid JSON. Invalid JSON will cause parsing errors before the request is sent.
  • API Authentication Errors: If the API key credential is not configured properly or has expired, authentication will fail.
  • Network or API Errors: Connectivity issues or API downtime can cause failures. Check network access and API status.

Common error messages might include unauthorized access, bad request due to invalid JSON, or server errors. Verify input properties and credentials to resolve these.

Links and References

Discussion