> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Magnetic

> Magnetic is an all-in-one platform designed to help professional services firms manage projects, resources, and finances efficiently.

![Magnetic logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/magnetic.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=e1a5eb7bc1c9e0f3442c8e7119f833f8)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `MAGNETIC`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Current Follow-ups
>
> **Slug:** `MAGNETIC_CLIENTS_GET_CURRENT_FOLLOWUPS`
>
> Tool to retrieve upcoming follow-ups assigned to the authenticated user. Use after authentication to view scheduled tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Client Contacts
>
> **Slug:** `MAGNETIC_CLIENTS_SEARCH_CONTACTS`
>
> Tool to search contacts by field or client ID. Use when you need to retrieve client contacts matching given criteria after authentication.
>
> #### Input Parameters
>
> **field** `string`
>
> The contact field to search by (e.g., 'email', 'name').
>
> **limit** `integer`
>
> Maximum number of results to return.
>
> **value** `string`
>
> The value to match in the specified field.
>
> **offset** `integer`
>
> Number of items to skip for pagination.
>
> **clientId** `integer`
>
> Filter results to contacts belonging to this client ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Magnetic Grouping
>
> **Slug:** `MAGNETIC_CREATE_GROUPING`
>
> Tool to create a new opportunity or job (grouping) in Magnetic HQ. Use when you need to organize tasks and track project progress for a new opportunity or job.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the new opportunity or job grouping
>
> **extra** `string`
>
> Description or additional details about the opportunity/job
>
> **owner** `object` *required*
>
> The user who will be the owner of this grouping. Must provide user ID.
>
> **contact** `object`
>
> Contact object to associate with the grouping.
>
> **contactCompany** `object`
>
> Company object to associate with the grouping.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Magnetic Task
>
> **Slug:** `MAGNETIC_CREATE_TASK`
>
> Tool to create a new task in Magnetic HQ. Use when you need to add tasks to the system, optionally assigning them to users or linking to opportunities.
>
> #### Input Parameters
>
> **task** `string` *required*
>
> Name of the task to create. This is the primary identifier displayed for the task.
>
> **user** `object`
>
> Reference to a user to assign the task to.
>
> **endDate** `string`
>
> End date or due date for the task in ISO 8601 format (e.g., '2024-01-20T17:00:00Z').
>
> **billable** `boolean`
>
> Whether time tracked on this task should be billable. Set to true for client-billable work.
>
> **grouping** `object`
>
> Reference to a grouping/opportunity to associate with the task.
>
> **startDate** `string`
>
> Start date for the task in ISO 8601 format (e.g., '2024-01-15T09:00:00Z').
>
> **description** `string`
>
> Detailed description of the task. Can contain additional context or instructions.
>
> **timeMinutes** `integer`
>
> Amount of time already tracked on this task, in minutes.
>
> **effortMinutes** `integer`
>
> Estimated effort for this task, in minutes. Used for time estimation and planning.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Tags
>
> **Slug:** `MAGNETIC_GET_CONTACT_TAGS`
>
> Tool to get all tags associated with a contact. Use after confirming the contactId to list contact tags.
>
> #### Input Parameters
>
> **contactId** `integer` *required*
>
> Unique ID of the contact whose tags to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Magnetic Grouping by ID
>
> **Slug:** `MAGNETIC_GET_GROUPING_BY_ID`
>
> Retrieve details for a Magnetic grouping (opportunity or job) by its positive ID. Use this to inspect information such as its name, status, description and dates.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique ID of the grouping/opportunity to retrieve (must be positive).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Grouping Statuses
>
> **Slug:** `MAGNETIC_GET_GROUPING_STATUSES`
>
> Tool to retrieve the list of statuses for signed groupings. Use after authentication when you need available grouping status options for tasks or jobs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Grouping Tags
>
> **Slug:** `MAGNETIC_GET_GROUPING_TAGS`
>
> Tool to retrieve tags associated with any groupings owned by the company. Use after authentication when grouping tags are needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Magnetic Opportunity Statuses
>
> **Slug:** `MAGNETIC_GET_OPPORTUNITY_STATUSES`
>
> Tool to retrieve opportunity statuses. Use when you need current status options for unsigned groupings (opportunities).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Magnetic Task
>
> **Slug:** `MAGNETIC_GET_TASK`
>
> Tool to retrieve a task by its ID. Use after confirming you have the taskId.
>
> #### Input Parameters
>
> **taskId** `integer` *required*
>
> The unique ID of the task to retrieve (must be positive).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User by ID
>
> **Slug:** `MAGNETIC_GET_USER_BY_ID`
>
> Tool to retrieve details for a specific Magnetic user by their ID. Use when you need to fetch a user's profile information.
>
> #### Input Parameters
>
> **id** `integer` *required*
>
> The unique identifier of the user to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Users
>
> **Slug:** `MAGNETIC_GET_USERS`
>
> Tool to retrieve the list of all users in the authenticated user's company. Use after authentication to audit or manage user accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Companies
>
> **Slug:** `MAGNETIC_LIST_COMPANIES`
>
> List companies from the Magnetic HQ account, with optional limit and offset applied to the returned list.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of companies to return.
>
> **offset** `integer`
>
> Number of items to skip for pagination.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Grouping Custom Field Definitions
>
> **Slug:** `MAGNETIC_TASKS_GET_GROUPING_CUSTOM_FIELD_DEFINITIONS`
>
> Tool to retrieve all custom field definitions for groupings. Use after authentication when you need to fetch available grouping custom field definitions for tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
