# Godial

GoDial is an automatic call app, mobile CRM, and outbound dialer software that transforms your phone into a call center, enabling efficient management of calls and contacts.

- **Category:** crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `GODIAL`
- **Version:** 20260312_00

## Tools

### Add GoDial Contact

**Slug:** `GODIAL_ADD_CONTACT`

Add a new contact to a GoDial CRM list. Requires a valid list ID (obtain from List External Lists action) and phone number. Returns the created contact with assigned ID, timestamps, and lead score.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Contact's name |
| `note` | string | No | Free-form note about the contact |
| `email` | string | No | Contact's email address |
| `extra` | string | No | Any extra/custom data to store with the contact |
| `phone` | string | Yes | Primary phone number (required) |
| `listId` | string | Yes | ID of the list where the new contact will be added |
| `remarks` | string | No | Additional remarks |
| `companyName` | string | No | Company or organization name |
| `secondPhone` | string | No | Secondary phone number |
| `assignmentMode` | string | No | Assignment behavior for the contact (e.g., default) |

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

### Add GoDial Contact List

**Slug:** `GODIAL_ADD_LIST`

Tool to create a new contact list in GoDial. Use when you need to add a list for organizing contacts within a team. Requires a valid team ID (obtain from List Accounts action).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the contact list to create |
| `teamsId` | string | Yes | The ID of the team to which this list will be assigned |

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

### Add Task to GoDial

**Slug:** `GODIAL_ADD_TASK`

Add a new task to GoDial. Use when you need to create a task and assign it to a specific account. Requires account ID which can be obtained from List Accounts action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the task |
| `accountsId` | string | Yes | The ID of the account to assign the task to. Use List Accounts action to retrieve available account IDs. |
| `description` | string | No | Detailed description of the task |

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

### Add GoDial Team

**Slug:** `GODIAL_ADD_TEAM`

Tool to add a new team to your GoDial company. Use when you need to create a team for organizing accounts or users within your organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the team to create |

#### 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 GoDial Contact by Phone

**Slug:** `GODIAL_DELETE_CONTACT_BY_PHONE`

Tool to delete a contact from a GoDial list by phone number. Use when you need to remove a specific contact identified by their phone number from a particular list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phone` | string | Yes | Phone number of the contact to delete (e.g., +1234567890) |
| `listId` | string | Yes | ID of the list containing the contact |

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

### Dispose GoDial Contact

**Slug:** `GODIAL_DISPOSE_CONTACT`

Tool to insert disposition details for a contact (e.g., call outcome). Use after completing a call to record the result. Requires valid disposition status configured in the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Contact ID to dispose |
| `type` | string | Yes | Type of call (e.g., 'call') |
| `dispo` | string | Yes | Disposition status (e.g., SALE, NO ANSWER, INTERESTED, BUSY). Must be a valid disposition configured in the system. |
| `calledOn` | string | Yes | Timestamp when the contact was called (ISO 8601 format) |
| `callerId` | string | Yes | ID of the agent/account making the call |

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

### Retrieve GoDial Accounts

**Slug:** `GODIAL_LIST_ACCOUNTS`

Tool to retrieve all accounts in the authenticated GoDial account. Use after obtaining access token to fetch available accounts. Supports optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve, 1-indexed |
| `perPage` | integer | No | Number of accounts per page |

#### 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 GoDial Contacts

**Slug:** `GODIAL_LIST_CONTACTS`

Tool to retrieve all contacts from a specific GoDial list. Use when you need to view or enumerate contacts within a list by providing the list ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `listId` | string | Yes | The ID of the contact list to retrieve contacts from |

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

### Retrieve GoDial External Lists

**Slug:** `GODIAL_LIST_EXTERNAL_LISTS`

Tool to retrieve all lists in the authenticated GoDial account. Use when you need to enumerate lists for selecting a target list ID after configuring your External API access token.

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

### Retrieve GoDial Tasks

**Slug:** `GODIAL_LIST_TASKS`

Tool to retrieve all tasks in the authenticated GoDial account. Use when you need to enumerate tasks for viewing, filtering, or managing task workflows.

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

### Retrieve GoDial Teams

**Slug:** `GODIAL_LIST_TEAMS`

Tool to retrieve all teams in the authenticated GoDial company. Use when you need to enumerate teams for your company after configuring your External API access token.

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

### Remove GoDial Account

**Slug:** `GODIAL_REMOVE_ACCOUNT`

Tool to remove a GoDial account. Use when an account needs to be permanently deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the GoDial account to remove |

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

### Remove Account from Company

**Slug:** `GODIAL_REMOVE_ACCOUNT2`

Tool to remove an account from your GoDial company. Use when you need to delete a specific account by its ID. Returns the count of accounts removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the account to remove from the company |

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

### Remove GoDial Contact

**Slug:** `GODIAL_REMOVE_CONTACT`

Tool to remove a contact from GoDial by ID. Use when a contact needs to be deleted from a list. Returns the count of contacts removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the contact to remove |

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

### Remove GoDial Contact List

**Slug:** `GODIAL_REMOVE_LIST`

Tool to remove a contact list from GoDial. Use when you need to delete a specific list by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the contact list to remove |

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

### Remove GoDial Task

**Slug:** `GODIAL_REMOVE_TASK`

Tool to remove a particular task from GoDial. Use when a task needs to be deleted. Returns the count of tasks removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the task to remove |

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

### Remove GoDial Team

**Slug:** `GODIAL_REMOVE_TEAM`

Tool to remove a team from your GoDial company. Use when you need to permanently delete a team from your organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the team to remove |

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

### Update GoDial Contact

**Slug:** `GODIAL_UPDATE_CONTACT`

Update an existing contact in GoDial CRM. Requires contact ID and at least one field to update. Returns the updated contact with all current field values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the contact to update |
| `name` | string | No | The name of the contact |
| `note` | string | No | Notes about the contact |
| `email` | string | No | The email of the contact |
| `extra` | string | No | Extra data about the contact |
| `phone` | string | No | The phone number of the contact |
| `remarks` | string | No | Remarks about the contact |
| `companyName` | string | No | Company name of the contact |
| `secondPhone` | string | No | Secondary phone number |

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

### Update GoDial List

**Slug:** `GODIAL_UPDATE_LIST`

Tool to update an existing contact list in GoDial. Use when you need to modify list properties such as name, team assignment, call script, or Indiamart integration settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the list to update |
| `name` | string | No | The new name for the list |
| `teamsId` | string | No | The team ID to assign the list to |
| `indiamart` | object | No | Indiamart integration configuration for the list |
| `callScript` | string | No | Call script for the list |
| `twillioAudioUrl` | string | No | Twilio audio URL for the list |

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

### Update GoDial Team

**Slug:** `GODIAL_UPDATE_TEAM`

Update an existing team in GoDial. Requires a valid team ID and the new team name. Returns the updated team details with timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The team ID to update |
| `name` | string | No | The new name for the team |

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

### View GoDial Contact

**Slug:** `GODIAL_VIEW_CONTACT`

Tool to view details of a specific contact by ID. Use when you need to retrieve complete information about a contact including phone, email, company details, and lead tracking data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the contact to view |

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

### View GoDial Contact List Details

**Slug:** `GODIAL_VIEW_LIST`

Tool to view details of a specific contact list by ID. Use when you need to retrieve detailed information about a list including its name, associated company/team, and configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the contact list to view |

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

### View GoDial Task

**Slug:** `GODIAL_VIEW_TASK`

Tool to view details of a specific task by ID. Use when you need to retrieve information about a task in GoDial. Returns task details including name, status, assigned account, and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the task to view |

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

### View GoDial Team

**Slug:** `GODIAL_VIEW_TEAM`

Tool to view details of a specific team by ID. Use when you need to retrieve information about a particular team in the GoDial account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The team ID to view |

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