Magnet Customer icon

Magnet Customer

Consume Magnet Customer API

Actions68

Overview

This node integrates with the Magnet Customer API to manage various CRM resources, including tasks. Specifically, for the Task - Delete operation, it deletes a task identified by its unique Task ID. This is useful in scenarios where you want to automate cleanup or removal of outdated or completed tasks from your CRM system.

Practical examples:

  • Automatically deleting tasks after they are marked as done in another system.
  • Removing test or placeholder tasks created during data import workflows.
  • Cleaning up tasks related to contacts that have been deleted or archived.

Properties

Name Meaning
Authentication Method used to authenticate API requests. Options: "API Token", "OAuth2".
Task ID The unique identifier of the task to delete. This is required to specify which task to remove.
Life Cycle (Hidden) Represents the life cycle stage of the contact; preset internally (not user-editable).
Source (Hidden) Indicates the source of the contact; preset internally (not user-editable).

Note: The hidden properties Life Cycle and Source are set internally and not exposed for user input in this operation.

Output

The node outputs JSON data representing the result of the delete operation for each input item. Typically, this will be a confirmation of deletion or an empty object if the API does not return content on successful deletion.

If an error occurs during deletion, the output JSON will contain an error field with the error message, provided the node is configured to continue on failure.

No binary data is produced by this operation.

Dependencies

  • Requires access to the Magnet Customer API.
  • Requires valid authentication credentials, either via an API token or OAuth2.
  • The node expects the taskId parameter to be provided for identifying the task to delete.
  • No additional environment variables or external services are needed beyond the API credentials.

Troubleshooting

  • Common issues:

    • Missing or invalid Task ID: The node requires a valid task ID to perform deletion. Ensure the ID is correct and corresponds to an existing task.
    • Authentication errors: Verify that the API token or OAuth2 credentials are correctly configured and have sufficient permissions.
    • Network or API downtime: Temporary connectivity issues can cause failures.

  • Error messages:

    • "error": "Task not found": The specified Task ID does not exist. Check the ID value.
    • "error": "Unauthorized" or "Authentication failed": Credentials are invalid or expired. Re-authenticate.
    • Other HTTP errors returned by the API will be passed through; consult the Magnet Customer API documentation for details.

  • To handle errors gracefully, enable the node's "Continue On Fail" option to process subsequent items even if one fails.

Links and References

Discussion