N8N Tools - Typebot API icon

N8N Tools - Typebot API

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

Actions23

Overview

The "Invite Member" operation in the Workspace resource allows users to invite new members to a specific workspace within the Typebot.io platform. This node sends an invitation email to the specified address, adding the recipient as a member of the workspace with a defined role (e.g., member or admin). It is useful for collaborative environments where multiple users need access to manage or interact with chatbots and related resources.

Practical examples:

  • Automatically inviting team members to a shared workspace when onboarding new employees.
  • Adding external collaborators or clients to a workspace to allow them to view or edit chatbot configurations.
  • Managing workspace membership programmatically as part of a larger automation workflow.

Properties

Name Meaning
Additional Fields Collection of optional fields to customize the invitation:
- Email The email address of the person to invite to the workspace.
- Member Type Role assigned to the invited member; options include "MEMBER" (default) and potentially others.

Note: Only the email and memberType fields from the additional fields collection are relevant for this operation.

Output

The node outputs a JSON object representing the response from the Typebot API after attempting to send the invitation. This typically includes details about the invitation status or any errors encountered.

Example output structure:

{
  "invitationId": "string",
  "email": "string",
  "type": "MEMBER",
  "status": "PENDING"
}

The exact fields depend on the API response but generally confirm that the invitation was created successfully.

Dependencies

  • Requires an API key credential for authenticating with the Typebot API.
  • Needs the workspace ID configured in the node credentials or environment.
  • The node makes HTTP requests to the Typebot API endpoint, so network connectivity to the API service is required.

Troubleshooting

  • Common issues:

    • Invalid or missing email address in the invitation field will cause the API to reject the request.
    • Insufficient permissions of the API token may result in authorization errors.
    • Network or connectivity problems can cause request failures.

  • Error messages:

    • "Unknown workspace operation: inviteMember": Indicates a misconfiguration or outdated node version; ensure the operation name is correct.
    • Authorization errors usually mention invalid or missing tokens; verify API credentials.
    • Validation errors from the API often specify which input field is incorrect or missing.

  • Resolutions:

    • Double-check the email format and presence.
    • Confirm the API key has sufficient rights to invite members.
    • Ensure the workspace ID is correctly set in credentials.
    • Check network access to the Typebot API endpoint.

Links and References

  • Typebot API Documentation — Official API reference for workspace and member management.
  • Typebot.io Website — Platform homepage and user guides.
  • n8n Community Forum — For community support and sharing workflows involving Typebot nodes.

Discussion