Actions68
- Custom Field Actions
- Custom Field Block Actions
- Custom Field Type Actions
- Customer Actions
- Deal Actions
- Lead Actions
- Organization Actions
- Pipeline Actions
- Prospect Actions
- Staff Actions
- Task Actions
- Workspace Actions
Overview
This node integrates with the Magnet Customer API to manage staff members within an organization. Specifically, the "Staff" resource with the "Create" operation allows users to add new staff members by providing their details such as full name, email, phone numbers, role, and workspace associations. This is useful for automating HR or team management workflows where new staff records need to be created programmatically based on external triggers or data sources.
Practical examples include:
- Automatically adding new employees from a recruitment system into the Magnet Customer platform.
- Syncing staff details from other databases or CRMs into Magnet Customer.
- Creating staff profiles as part of onboarding automation flows.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate API requests: either "API Token" or "OAuth2". |
| Nome Completo | Full name of the staff member to create. |
| Email address of the staff member. | |
| Telefone | Phone number of the staff member (optional). |
| Telefone (WhatsApp) | WhatsApp phone number of the staff member (optional). |
| Role Name or ID | The role assigned to the staff member. Choose from a list of roles or specify an ID via expression. |
| IDs Do Workspace | List of workspace IDs to associate the staff member with. Multiple values can be added. |
| Custom Fields | Collection of custom fields to set on the staff member. Each custom field requires a field name or ID and a value. |
Note: There are several hidden properties related to "Life Cycle" and "Source" with default values, but these are not exposed for user input in this operation.
Output
The node outputs JSON data representing the newly created staff member(s) as returned by the Magnet Customer API. The output includes all standard and custom fields that were set or generated during creation.
If multiple items are processed, the output is an array of JSON objects, each corresponding to one created staff record.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Magnet Customer API.
- Supports two authentication methods: API Token or OAuth2 credentials.
- The node depends on the availability of roles and workspaces in the Magnet Customer system to assign them correctly.
- Custom fields must exist in the Magnet Customer system and be creatable for staff to be set via this node.
Troubleshooting
- Invalid Role or Workspace ID: If the specified role or workspace IDs do not exist or are invalid, the API will likely return an error. Ensure the IDs are correct and accessible.
- Authentication Errors: Using incorrect or expired API tokens or OAuth2 credentials will cause authentication failures. Verify credentials and refresh tokens if needed.
- Missing Required Fields: Omitting required fields like full name or email may result in validation errors from the API.
- Custom Field Issues: Setting custom fields with invalid IDs or unsupported values can cause errors. Use the provided load options to select valid custom fields.
- API Rate Limits: Excessive requests might trigger rate limiting; implement retries or delays as necessary.
Links and References
This summary is based solely on static analysis of the provided source code and property definitions.