# Salesmate

Salesmate is an AI-powered CRM platform designed to help businesses engage leads, close deals faster, nurture relationships, and provide seamless support through a unified, intuitive interface.

- **Category:** crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `SALESMATE`
- **Version:** 20260227_00

## Tools

### Add Product

**Slug:** `SALESMATE_ADD_PRODUCT`

Tool to add a new product. Use when you need to create a new product in Salesmate before referencing it (e.g., in deals or orders). Example: "Add a product named 'Widget Pro' (SKU WPRO1) priced at 199.99 USD."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sku` | string | No | Unique SKU/code of the product |
| `name` | string | Yes | Name of the product |
| `tags` | string | No | Comma-separated tags (max 5000 chars) |
| `owner` | integer | No | Salesmate user ID that owns the product |
| `currency` | string | Yes | Three-letter ISO currency code, uppercase |
| `isActive` | boolean | No | Whether the product is active for sales |
| `unitPrice` | number | Yes | Sale price of the product (non-negative) |
| `directCost` | number | No | Optional direct cost of the product (non-negative) |
| `costPerUnit` | number | No | Optional cost per unit (non-negative) |
| `description` | string | No | Optional description (max 2000 chars) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Company

**Slug:** `SALESMATE_CREATE_COMPANY`

Tool to create a new company in the Salesmate CRM. Use when you need to register a new organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the company (max 255 chars) |
| `tags` | string | No | Comma-separated tags for the company |
| `owner` | integer | No | ID of the owner user for this company. If not provided, defaults to the authenticated user. |
| `phone` | string | No | Primary phone number of the company |
| `skypeId` | string | No | Skype ID of the company |
| `website` | string | No | Website URL of the company |
| `currency` | string | No | Three-letter ISO currency code (uppercase) |
| `otherPhone` | string | No | Secondary phone number of the company |
| `billingCity` | string | No | Billing city |
| `description` | string | No | Description for the company |
| `billingState` | string | No | Billing state |
| `twitterHandle` | string | No | Twitter handle of the company |
| `billingCountry` | string | No | Billing country |
| `billingZipCode` | string | No | Billing ZIP/postal code |
| `facebookHandle` | string | No | Facebook profile or handle of the company |
| `linkedInHandle` | string | No | LinkedIn profile link of the company |
| `googlePlusHandle` | string | No | Google Plus profile link of the company |
| `billingAddressLine1` | string | No | Billing address line 1 |
| `billingAddressLine2` | string | No | Billing address line 2 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Product

**Slug:** `SALESMATE_DELETE_PRODUCT`

Tool to delete a product by ProductId. Use when you need to remove a product from the catalog after confirming the correct ProductId.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_id` | integer | Yes | Unique identifier of the product to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Active Users

**Slug:** `SALESMATE_GET_ACTIVE_USERS`

Tool to retrieve all active users. Use when you need to fetch only users currently marked active for tasks, assignments, or user management audits.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company

**Slug:** `SALESMATE_GET_COMPANY`

Tool to retrieve details of a specific company by ID. Use when you have a company ID and need its full record. Example: "Get company 42".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | integer | Yes | Unique identifier of the company to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Modules

**Slug:** `SALESMATE_LIST_MODULES`

Tool to list all available Salesmate modules. Returns the core CRM modules including Contacts, Companies, Deals, Activities, Products, and Tickets. Use this to discover which modules are available for API operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |