N8N Tools - Typebot API icon

N8N Tools - Typebot API

Complete Typebot.io integration - Self-hosted chatbot builder with visual flows

Actions23

Overview

This node integrates with the Typebot.io API, specifically focusing on managing workspaces and their members. The "List Members" operation retrieves all members of a specified workspace. This is useful for scenarios where you need to audit, manage, or synchronize workspace membership data programmatically.

Practical examples include:

  • Automatically fetching and listing all users in a workspace to display in an internal dashboard.
  • Integrating workspace member data with other systems like CRM or user management platforms.
  • Periodically auditing workspace membership for compliance or security reviews.

Properties

Name Meaning
Additional Fields Optional extra parameters that can be added; for "List Members" operation, no specific additional fields are used here.

Note: For the "List Members" operation under the "Workspace" resource, there are no required input properties besides selecting the operation itself. The workspace ID is taken from the credentials configuration.

Output

The output JSON contains the response from the Typebot API endpoint /api/v1/workspaces/{workspaceId}/members. This typically includes an array of member objects representing each workspace member with details such as user ID, email, role, status, and other metadata related to the workspace membership.

The output structure is:

{
  "json": {
    // API response containing workspace members list
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is returned by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Typebot API.
  • The node uses the workspace ID configured in the credentials to identify which workspace's members to list.
  • Network access to the Typebot API endpoint is necessary.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect workspace ID in credentials will result in errors or empty member lists.
    • Network connectivity problems may prevent successful API calls.

  • Error messages:

    • "Unknown workspace operation: listMembers": Indicates a mismatch between selected operation and implemented code; ensure the operation name is correct.
    • HTTP 401 Unauthorized: Check API key validity and permissions.
    • HTTP 404 Not Found: Verify the workspace ID exists and is accessible with the provided credentials.

  • Resolution tips:

    • Double-check API credentials and workspace ID configuration.
    • Ensure the API key has sufficient permissions to read workspace members.
    • Test connectivity to the Typebot API outside n8n to isolate network issues.

Links and References

Discussion