Actions43
- Location Groups Actions
- Locations Actions
- Roles Actions
- User Groups Actions
- Users Actions
- Affiliate Entity Groups Actions
- Attachments Actions
- Classes Actions
- Contacts Actions
- Department Groups Actions
- Departments Actions
- Document Sequences Actions
- Earning Types Actions
- Email Templates Actions
- Employee Types Actions
- Employees Actions
- Entities Actions
- Exchange Rate Lines Actions
- Exchange Rate Types Actions
- Exchange Rates Actions
- Attachment Folders Actions
- Get Next Value Actions
Overview
This node operation creates a new user group within a company's configuration in the Sage Intacct system. User groups are collections of users that share common permissions and roles, simplifying permission management across multiple users. This operation is useful for administrators who want to organize users into groups with specific access rights or responsibilities.
Practical examples include:
- Creating an "Accounts Payable" user group to manage all users responsible for processing invoices.
- Defining a "Warehouse Users" group that inherits warehouse-related permissions via assigned roles.
- Setting up custom user groups with specific descriptions and role assignments to streamline permission control.
Properties
| Name | Meaning |
|---|---|
| Id | The unique name identifier of the user group (e.g., "AP"). |
| Description | A textual description of the user group (e.g., "Accounts Payable"). |
| Additional Body Fields | Optional additional fields to include in the request body: - Key: System-assigned unique key identifying the user group. - Href: API endpoint URL for this user group. - Roles: JSON array of roles assigned to the group; each role includes a key, id, and href. Roles define inherited permissions. - Audit: JSON object containing audit metadata such as creation and modification timestamps and user IDs. |
Output
The node outputs JSON data representing the created user group resource as returned by the Sage Intacct API. This typically includes the group's identifiers, description, assigned roles, and audit information. There is no binary output.
Dependencies
- Requires an API key credential for authenticating requests to the Sage Intacct Company Configuration API.
- The base URL for the API must be configured in the node credentials.
- The node uses JSON-formatted HTTP requests and expects JSON responses.
Troubleshooting
- Missing required fields: Ensure both "Id" and "Description" are provided; these are mandatory.
- Invalid JSON in Roles or Audit fields: When providing JSON strings for roles or audit, ensure they are valid JSON; otherwise, parsing errors will occur.
- API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Network or endpoint errors: Confirm the base URL is correct and the Sage Intacct service is reachable.
- Role-based permissions mismatch: If roles are assigned but the company does not use role-based permissions, the roles field may have no effect.