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

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

![Godial logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/godial.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=d432ecda64a01524a0d0a1867c8fd550)

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

## Tools

> [accordion] Add GoDial Contact
>
> **Slug:** `GODIAL_ADD_CONTACT`
>
> Add a new contact to a GoDial CRM list using a list ID and phone number. Returns the raw response and, when available, parsed contact data.
>
> #### Input Parameters
>
> **name** `string`
>
> Contact's name
>
> **note** `string`
>
> Free-form note about the contact
>
> **email** `string`
>
> Contact's email address
>
> **extra** `string`
>
> Any extra/custom data to store with the contact
>
> **phone** `string` *required*
>
> Primary phone number (required)
>
> **listId** `string` *required*
>
> ID of the list where the new contact will be added
>
> **remarks** `string`
>
> Additional remarks
>
> **companyName** `string`
>
> Company or organization name
>
> **secondPhone** `string`
>
> Secondary phone number
>
> **assignmentMode** `string`
>
> Assignment behavior for the contact (e.g., default)
>
> #### 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] 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
>
> **name** `string` *required*
>
> The name of the contact list to create
>
> **teamsId** `string` *required*
>
> The ID of the team to which this list will be assigned
>
> #### 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] 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
>
> **name** `string` *required*
>
> The name of the task
>
> **accountsId** `string` *required*
>
> The ID of the account to assign the task to. Use List Accounts action to retrieve available account IDs.
>
> **description** `string`
>
> Detailed description of the task
>
> #### 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] 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
>
> **name** `string` *required*
>
> The name of the team to create
>
> #### 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 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
>
> **phone** `string` *required*
>
> Phone number of the contact to delete (e.g., +1234567890)
>
> **listId** `string` *required*
>
> ID of the list containing the contact
>
> #### 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] 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
>
> **id** `string` *required*
>
> Contact ID to dispose
>
> **type** `string` *required*
>
> Type of call (e.g., 'call')
>
> **dispo** `string` *required*
>
> Disposition status (e.g., SALE, NO ANSWER, INTERESTED, BUSY). Must be a valid disposition configured in the system.
>
> **calledOn** `string` *required*
>
> Timestamp when the contact was called (ISO 8601 format)
>
> **callerId** `string` *required*
>
> ID of the agent/account making the call
>
> #### 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] Retrieve GoDial Accounts
>
> **Slug:** `GODIAL_LIST_ACCOUNTS`
>
> Retrieve accounts in the authenticated GoDial account, with optional pagination.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, 1-indexed
>
> **perPage** `integer`
>
> Number of accounts per page
>
> #### 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 GoDial Contacts
>
> **Slug:** `GODIAL_LIST_CONTACTS`
>
> Retrieve contacts from a specific GoDial list by list ID. Optionally specify a page number and page size to view or enumerate contacts in the list.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, 1-indexed
>
> **listId** `string` *required*
>
> The ID of the contact list to retrieve contacts from
>
> **perPage** `integer`
>
> Number of contacts per page
>
> #### 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] 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
>
> **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] Retrieve GoDial Tasks
>
> **Slug:** `GODIAL_LIST_TASKS`
>
> Retrieve tasks in the authenticated GoDial account, with optional pagination, for viewing or managing task workflows.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve, 1-indexed
>
> **perPage** `integer`
>
> Number of tasks per page
>
> #### 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] 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
>
> **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] Remove GoDial Account
>
> **Slug:** `GODIAL_REMOVE_ACCOUNT`
>
> Tool to remove a GoDial account. Use when an account needs to be permanently deleted.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the GoDial account to remove
>
> #### 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] Remove Account from Company
>
> **Slug:** `GODIAL_REMOVE_ACCOUNT2`
>
> Remove a specific account from your GoDial company by its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the account to remove from the company
>
> #### 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] Remove GoDial Contact
>
> **Slug:** `GODIAL_REMOVE_CONTACT`
>
> Remove a GoDial contact by ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the contact to remove
>
> #### 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] 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
>
> **id** `string` *required*
>
> The unique identifier of the contact list to remove
>
> #### 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] Remove GoDial Task
>
> **Slug:** `GODIAL_REMOVE_TASK`
>
> Remove a particular task from GoDial by ID. The response does not provide a removal count.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier of the task to remove
>
> #### 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] 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
>
> **id** `string` *required*
>
> The unique identifier of the team to remove
>
> #### 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 GoDial Contact
>
> **Slug:** `GODIAL_UPDATE_CONTACT`
>
> Update a GoDial CRM contact by ID with the supplied fields. Returns the raw response and, when available, parsed contact data.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> ID of the contact to update
>
> **name** `string`
>
> The name of the contact
>
> **note** `string`
>
> Notes about the contact
>
> **email** `string`
>
> The email of the contact
>
> **extra** `string`
>
> Extra data about the contact
>
> **phone** `string`
>
> The phone number of the contact
>
> **remarks** `string`
>
> Remarks about the contact
>
> **companyName** `string`
>
> Company name of the contact
>
> **secondPhone** `string`
>
> Secondary phone number
>
> #### 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 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
>
> **id** `string` *required*
>
> The ID of the list to update
>
> **name** `string`
>
> The new name for the list
>
> **teamsId** `string`
>
> The team ID to assign the list to
>
> **indiamart** `object`
>
> Indiamart integration configuration for the list
>
> **callScript** `string`
>
> Call script for the list
>
> **twillioAudioUrl** `string`
>
> Twilio audio URL for the list
>
> #### 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 GoDial Team
>
> **Slug:** `GODIAL_UPDATE_TEAM`
>
> Update an existing GoDial team by ID, optionally supplying a new name. Returns the raw response and, when available, parsed team details that may include timestamps.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The team ID to update
>
> **name** `string`
>
> The new name for the team
>
> #### 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] View GoDial Contact
>
> **Slug:** `GODIAL_VIEW_CONTACT`
>
> View a specific GoDial contact by ID. Returned details may include phone, email, company details, and lead tracking data.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the contact to view
>
> #### 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] 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
>
> **id** `string` *required*
>
> The ID of the contact list to view
>
> #### 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] 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
>
> **id** `string` *required*
>
> Unique identifier of the task to view
>
> #### 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] 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
>
> **id** `string` *required*
>
> The team ID to view
>
> #### 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
