> ## 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.

# Agile CRM

> Agile CRM combines contact management, sales pipelines, marketing automation, tasks, campaigns, and customer support in one platform.

![Agile CRM logo](https://mintcdn.com/composio-preview/qzegrvAapILigeDI/images/toolkits/agile_crm.svg?fit=max\&auto=format\&n=qzegrvAapILigeDI\&q=85\&s=6cbf7df69f340403f0f60273adb9dc1a)

* **Category:** crm
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `AGILE_CRM`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Contact or Company
>
> **Slug:** `AGILE_CRM_CREATE_CONTACT_OR_COMPANY`
>
> Create a person contact with optional tags and scoring, or a company, with common and tenant custom properties.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Person first name for PERSON, or company name for COMPANY.
>
> **tags** `array`
>
> PERSON-only tags. Each starts with a letter and contains only letters, numbers, underscores, hyphens, and spaces. Do not set for COMPANY.
>
> **email** `string`
>
> Primary work email stored as a SYSTEM email property.
>
> **phone** `string`
>
> Primary work phone stored as a SYSTEM phone property.
>
> **last\_name** `string`
>
> Person's last name. Valid only when resource\_type is PERSON.
>
> **lead\_score** `integer`
>
> PERSON-only positive initial lead score. Do not set for COMPANY.
>
> **star\_value** `integer`
>
> PERSON-only initial star rating from 0 to 5. Do not set for COMPANY.
>
> **resource\_type** `string ("PERSON" | "COMPANY")` *required*
>
> Whether to create a person contact or a company.
>
> **custom\_properties** `array`
>
> Additional tenant custom-field values.
>
> **contact\_company\_id** `integer`
>
> Existing company ID to associate with a person. Valid only for PERSON.
>
> #### 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 Deal
>
> **Slug:** `AGILE_CRM_CREATE_DEAL`
>
> Create a deal, optionally associate contacts, and validate or resolve a case-sensitive milestone from the selected or default pipeline.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Deal name.
>
> **owner\_id** `integer`
>
> Agile CRM user ID that will own the deal.
>
> **milestone** `string`
>
> Exact case-sensitive milestone name. Omit to use the first milestone from the selected or default pipeline.
>
> **close\_date** `integer`
>
> Expected close time as Unix epoch seconds.
>
> **contact\_ids** `array`
>
> Person or company IDs to associate with the deal.
>
> **description** `string`
>
> Deal description.
>
> **pipeline\_id** `integer`
>
> Pipeline ID. Omit to use the tenant's default pipeline.
>
> **probability** `integer`
>
> Win probability percentage from 0 to 100.
>
> **custom\_fields** `array`
>
> Deal custom-field values sent to Agile CRM as custom\_data.
>
> **expected\_value** `number` *required*
>
> Expected monetary value of the deal, up to 1,000,000,000,000.
>
> #### 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] Delete Contact or Company
>
> **Slug:** `AGILE_CRM_DELETE_CONTACT_OR_COMPANY`
>
> Permanently delete one person contact or company by numeric ID.
>
> #### Input Parameters
>
> **resource\_id** `integer` *required*
>
> Numeric ID of the person contact or company to permanently delete.
>
> #### 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] Delete Deal
>
> **Slug:** `AGILE_CRM_DELETE_DEAL`
>
> Permanently delete one deal by its numeric Agile CRM ID.
>
> #### Input Parameters
>
> **deal\_id** `integer` *required*
>
> Numeric ID of the deal to permanently delete.
>
> #### 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 or Company
>
> **Slug:** `AGILE_CRM_GET_CONTACT_OR_COMPANY`
>
> Get one person contact or company by its numeric Agile CRM ID; return null when the resource does not exist.
>
> #### Input Parameters
>
> **resource\_id** `integer` *required*
>
> Numeric ID of the person contact or company 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 Deal
>
> **Slug:** `AGILE_CRM_GET_DEAL`
>
> Get one deal by its numeric Agile CRM ID; return null when the deal does not exist.
>
> #### Input Parameters
>
> **deal\_id** `integer` *required*
>
> Numeric ID of the deal 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] List Contacts
>
> **Slug:** `AGILE_CRM_LIST_CONTACTS`
>
> Return one creation-ordered page of person contacts, with a cursor for the next page when more contacts exist.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque next\_cursor from a previous call; omit for the first page.
>
> **page\_size** `integer`
>
> Maximum contacts to request in this page; Agile CRM documents no upper bound.
>
> #### 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 Deals
>
> **Slug:** `AGILE_CRM_LIST_DEALS`
>
> Return one creation-ordered page of deals, with a cursor for the next page when more deals exist.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque next\_cursor from a previous call; omit for the first page.
>
> **page\_size** `integer`
>
> Maximum deals to request in this page; Agile CRM documents no upper bound.
>
> #### 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] Update Contact or Company
>
> **Slug:** `AGILE_CRM_UPDATE_CONTACT_OR_COMPANY`
>
> Add or replace selected properties on one person contact or company without replacing properties that are not included.
>
> #### Input Parameters
>
> **properties** `array` *required*
>
> Properties to add or replace. Existing properties not included in this list remain unchanged.
>
> **resource\_id** `integer` *required*
>
> Numeric ID of the person contact or company to update. This is sent to Agile CRM as 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] Update Deal
>
> **Slug:** `AGILE_CRM_UPDATE_DEAL`
>
> Partially update selected fields of an existing deal. Pipeline or milestone changes are validated against the pipeline; selecting a pipeline without a milestone also sets its first milestone.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement deal name.
>
> **deal\_id** `integer` *required*
>
> Numeric ID of the deal to update. This is sent to Agile CRM as id.
>
> **milestone** `string`
>
> Replacement exact case-sensitive milestone name.
>
> **close\_date** `integer`
>
> Replacement expected close time as Unix epoch seconds.
>
> **contact\_ids** `array`
>
> Person or company IDs to add to the deal's existing associations. This partial-update operation cannot remove associations.
>
> **description** `string`
>
> Replacement deal description.
>
> **pipeline\_id** `integer`
>
> Replacement pipeline ID. When milestone is omitted, the pipeline's first milestone is selected.
>
> **probability** `integer`
>
> Replacement win probability percentage from 0 to 100.
>
> **custom\_fields** `array`
>
> Complete replacement set of deal custom-field values. This is sent to Agile CRM as custom\_data.
>
> **expected\_value** `number`
>
> Replacement expected monetary value, up to 1,000,000,000,000.
>
> #### 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
