Actions33
- Public Actions
- Public Admin Actions
- Reseller Actions
- Create New Team
- Get Team Information
- Update Team
- Remove Team From Reseller
- Update Team Avatar
- Create Team Bulk Inboxes And Users
- Get Team Users
- Add User To Team
- Remove Users From Team
- Get Team Inboxes
- Remove Team Inboxes
- Create Team Bulk Inboxes
- Assign Users To Inbox
- Remove Users From Inbox
- Get Team Whitelist Domains
- Create Team Whitelisted Domain
- Remove Team Whitelisted Domain
- Create Reseller
- Import Team Users
- Get Import Team Users Job Status
Overview
This node operation "Add User To Team" under the "Reseller" resource allows you to add a new user to an existing team by specifying the team's ID and the user's email address. It supports adding optional user details such as first name, last name, and role within the team.
Common scenarios for this node include automating team management workflows where users need to be programmatically added to teams in bulk or as part of onboarding processes. For example, when a new employee joins a company, this node can be used to add their account to the appropriate team with the correct role automatically.
Properties
| Name | Meaning |
|---|---|
| Team Id | The unique identifier of the team to which the user will be added. |
| The email address of the user to add to the team. | |
| Additional Body Fields | Optional fields to provide more user details: |
| - Firstname | The first name of the user. |
| - Lastname | The last name of the user. |
| - Role | The role assigned to the user within the team. Possible values: Workspace Owner, Admin, Agent, Manager, Member. |
Output
The node outputs JSON data representing the result of the API call to add the user to the team. This typically includes confirmation details such as the user's information and their assigned role within the team. There is no indication that binary data is output by this node.
Dependencies
- Requires an API key credential for authentication to the external service managing teams and users.
- The base URL for the API is configured via credentials.
- The node uses HTTP requests with JSON payloads to communicate with the external API.
Troubleshooting
- Missing Required Fields: Ensure that both "Team Id" and "Email" are provided; otherwise, the API call will fail.
- Invalid Team Id: If the team ID does not exist or is incorrect, the API will return an error indicating the team was not found.
- Email Format Issues: Providing an invalid email format may cause the request to be rejected.
- Role Value Errors: Assigning a role outside the allowed options will likely result in an error.
- Authentication Failures: Verify that the API key credential is correctly set up and has sufficient permissions.
- API Rate Limits: If many users are added in quick succession, the API might throttle requests.
Links and References
- Refer to the external API documentation for detailed information on the "Add User To Team" endpoint, including required permissions and request/response formats.
- n8n documentation on how to configure API credentials and use HTTP request nodes for custom integrations.