Attio icon

Attio

Interact with Attio API

Overview

This node operation "List Webhooks" for the "Webhooks" resource interacts with an external API to retrieve a list of webhooks. It is useful when you want to programmatically fetch and manage webhook configurations from the connected service, such as displaying all registered webhooks or processing them further in your workflow.

Typical use cases include:

  • Auditing or monitoring existing webhooks.
  • Synchronizing webhook data with other systems.
  • Automating webhook management tasks.

For example, you might use this node to get the first 20 webhooks configured in your account and then filter or analyze them downstream in your workflow.

Properties

Name Meaning
Limit The maximum number of webhook results to return. Accepts a number between 10 and 100. Defaults to 10. Controls pagination size.
Offset The number of webhook results to skip before starting to return results. Defaults to 5. Used for pagination to skip over earlier entries.

Output

The output is a JSON array where each item represents a webhook object retrieved from the API. Each webhook object contains details about a specific webhook configuration as returned by the external service.

The node does not output binary data.

Example output structure (simplified):

[
  {
    "id": "webhook_123",
    "url": "https://example.com/webhook",
    "events": ["event1", "event2"],
    "active": true,
    ...
  },
  ...
]

Each item in the output corresponds to one webhook entry, allowing further processing or filtering in subsequent nodes.

Dependencies

  • Requires an API key credential for authenticating requests to the external service.
  • The node sends HTTP requests to the service's REST API endpoint https://api.attio.com/v2/webhooks.
  • No additional environment variables are required beyond the API authentication token.

Troubleshooting

  • Common issues:

    • Invalid or expired API token will cause authentication errors.
    • Providing a limit value outside the allowed range (less than 10 or greater than 100) may result in API errors.
    • Network connectivity problems can cause request failures.
  • Error messages:

    • "Operation List Webhooks not found for resource Webhooks": This indicates a misconfiguration or unsupported operation selection.
    • HTTP 401 Unauthorized: Check that the API key credential is valid and has proper permissions.
    • HTTP 400 Bad Request: Verify that limit and offset parameters are within acceptable ranges.
  • Resolution tips:

    • Ensure the API key credential is correctly set up and active.
    • Use default or valid values for pagination parameters.
    • Confirm network access to the API endpoint.

Links and References

Discussion