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

# Dialmycalls

> DialMyCalls provides a mass notification system enabling users to send voice and text messages to contacts.

![Dialmycalls logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/dialmycalls.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=e104574e43a5745cbc7dfe40fce03ff5)

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

## Tools

> [accordion] Add Access Account
>
> **Slug:** `DIALMYCALLS_ADD_ACCESS_ACCOUNT`
>
> Tool to add a new access (sub) account. Use when you need to delegate dialing capabilities to another user after setting up your master account.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the access (sub) account to create.
>
> **email** `string` *required*
>
> Email address for the new access (sub) account.
>
> **password** `string` *required*
>
> Password for the new access (sub) account; follow strong password policy.
>
> **permissions** `array`
>
> Optional list of permissions to assign. Eg: \['CALL\_CREATE','VIEW\_REPORTS']. If omitted, default permissions apply.
>
> #### 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 Contact
>
> **Slug:** `DIALMYCALLS_ADD_CONTACT`
>
> Tool to add a contact to your contact list. Use when you need to store a new contact's phone (and optional name, email, or group) before sending messages.
>
> #### Input Parameters
>
> **email** `string`
>
> The email address of the contact.
>
> **phone** `string` *required*
>
> The phone number of the contact.
>
> **group\_id** `string`
>
> The unique identifier of the group to which the contact should be added.
>
> **last\_name** `string`
>
> The last name of the contact.
>
> **first\_name** `string`
>
> The first name of 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] Add Group
>
> **Slug:** `DIALMYCALLS_ADD_GROUP`
>
> Tool to add a new contact group. Use after deciding the group name to organize recipients into groups.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the group to create. Must be non-empty.
>
> #### 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 Access Account
>
> **Slug:** `DIALMYCALLS_DELETE_ACCESS_ACCOUNT`
>
> Tool to delete an access (sub) account by ID. Use when removing a sub account after deprovisioning.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID or UUID of the access (sub) account to 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 Caller ID
>
> **Slug:** `DIALMYCALLS_DELETE_CALLER_ID`
>
> Tool to delete a caller ID. Use when you need to permanently remove an existing caller ID no longer in use.
>
> #### Input Parameters
>
> **caller\_id** `string` *required*
>
> The unique identifier of the caller ID to 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 Contact
>
> **Slug:** `DIALMYCALLS_DELETE_CONTACT`
>
> Tool to delete a contact by ID. Use when you need to permanently remove a contact from your list.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> The unique identifier of the contact to delete (path parameter)
>
> #### 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 Group
>
> **Slug:** `DIALMYCALLS_DELETE_GROUP`
>
> Tool to delete a contact group by ID. Use when you need to remove an existing contact group after confirming its ID.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> The unique identifier (UUID) of the group to 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 Recording
>
> **Slug:** `DIALMYCALLS_DELETE_RECORDING`
>
> Tool to delete a recording by ID. Use when you need to permanently remove a custom recording after confirming its recording ID.
>
> #### Input Parameters
>
> **recording\_id** `string` *required*
>
> The ID of the recording to 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 Access Account
>
> **Slug:** `DIALMYCALLS_GET_ACCESS_ACCOUNT`
>
> Tool to retrieve an access (sub) account by ID. Use when you need to inspect the details of a specific sub-account.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the access (sub) account 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 Account
>
> **Slug:** `DIALMYCALLS_GET_ACCOUNT`
>
> Tool to retrieve your main account details. Use when you need to confirm account ID, remaining credits, and status.
>
> #### 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 Caller ID
>
> **Slug:** `DIALMYCALLS_GET_CALLER_ID`
>
> Tool to retrieve a caller ID by ID. Use when you need its details such as phone number and verification status.
>
> #### Input Parameters
>
> **caller\_id** `string` *required*
>
> The unique identifier of the caller ID 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 Contact
>
> **Slug:** `DIALMYCALLS_GET_CONTACT`
>
> Tool to retrieve a contact by its unique ID. Use when you need to fetch details of a specific contact from your account.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> The unique identifier (UUID) of the contact 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 Group
>
> **Slug:** `DIALMYCALLS_GET_GROUP`
>
> Retrieve a contact group by ID to review its details, for example after creating or updating it.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> The ID of the group 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 Recording
>
> **Slug:** `DIALMYCALLS_GET_RECORDING`
>
> Retrieve a recording by ID to review its details and recording file URL.
>
> #### Input Parameters
>
> **recording\_id** `string` *required*
>
> The unique identifier of the recording 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 Access Accounts
>
> **Slug:** `DIALMYCALLS_LIST_ACCESS_ACCOUNTS`
>
> Tool to list all access (sub) accounts. Use when you need to retrieve paginated sub-account information for administration or reporting.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for paginated results (default: 1).
>
> **per\_page** `integer`
>
> Number of results per page (default: 20).
>
> #### 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 Caller IDs
>
> **Slug:** `DIALMYCALLS_LIST_CALLER_I_DS`
>
> List caller IDs on the account.
>
> #### 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 Calls
>
> **Slug:** `DIALMYCALLS_LIST_CALLS`
>
> Tool to list all call broadcasts on the account. Use when you need to retrieve or manage call records with optional filters like name, type, status, dates, pagination, and sorting.
>
> #### Input Parameters
>
> **sort** `string ("id" | "created")`
>
> Field to sort by.
>
> **type** `string ("normal" | "survey" | "poll" | "reminder")`
>
> Type of voice broadcast to filter.
>
> **limit** `integer`
>
> Number of records to return (max 1000).
>
> **order** `string ("asc" | "desc")`
>
> Sort order.
>
> **offset** `integer`
>
> Record offset for pagination.
>
> **status** `string ("draft" | "sent" | "scheduled" | "stopped")`
>
> Status of the broadcast to filter.
>
> **keyword** `string`
>
> Search filter for the call name.
>
> **end\_date** `string`
>
> Filter broadcasts created on or before this date (YYYY-MM-DD).
>
> **start\_date** `string`
>
> Filter broadcasts created on or after this date (YYYY-MM-DD).
>
> #### 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:** `DIALMYCALLS_LIST_CONTACTS`
>
> Tool to list all contacts in your contact list. Use when fetching paginated or filtered contact data for review (e.g., after adding or updating contacts).
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of contacts to return.
>
> **offset** `integer`
>
> Zero-based index to start returning contacts from.
>
> **search** `string`
>
> Keyword to filter contacts by name, phone, or email.
>
> #### 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 Do Not Contacts
>
> **Slug:** `DIALMYCALLS_LIST_DO_NOT_CONTACTS`
>
> List Do Not Contact entries for review. The request accepts pagination, type and search parameters.
>
> #### Input Parameters
>
> **type** `string ("phone" | "email")`
>
> Filter entries by type: 'phone' or 'email'.
>
> **limit** `integer`
>
> Number of records to return (default 10, max 1000).
>
> **offset** `integer`
>
> Number of records to skip for pagination (default 0).
>
> **search** `string`
>
> Search term to filter matching phone numbers or emails.
>
> #### 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 Groups
>
> **Slug:** `DIALMYCALLS_LIST_GROUPS`
>
> List contact groups to get an overview of existing groups before sending messages.
>
> #### 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 Recordings
>
> **Slug:** `DIALMYCALLS_LIST_RECORDINGS`
>
> List account recordings for auditing or management, with optional page and limit parameters. The requested limit can be up to 100.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number of results to retrieve (first page is 1)
>
> **limit** `integer`
>
> Number of results per page (default is 10, max is 100)
>
> #### 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 Text Broadcasts
>
> **Slug:** `DIALMYCALLS_LIST_TEXTS`
>
> List outgoing text broadcasts for review, with optional date, status, limit, and offset parameters. The requested limit can be up to 100.
>
> #### Input Parameters
>
> **end** `string`
>
> Filter texts created before this date (YYYY-MM-DD).
>
> **limit** `integer`
>
> Number of results to return per page (default 10 if not set, max 100).
>
> **start** `string`
>
> Filter texts created after this date (YYYY-MM-DD).
>
> **offset** `integer`
>
> Number of items to skip before starting to collect the result set.
>
> **status** `string`
>
> Filter texts by status (e.g., 'sent', 'queued', 'failed').
>
> #### 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 Vanity Numbers
>
> **Slug:** `DIALMYCALLS_LIST_VANITY_NUMBERS`
>
> List vanity numbers on the account, with optional limit and offset parameters for pagination. The requested limit can be up to 100.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of records to return per page (max 100).
>
> **offset** `integer`
>
> Record offset 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] Update Access Account
>
> **Slug:** `DIALMYCALLS_UPDATE_ACCESS_ACCOUNT`
>
> Tool to update an existing access (sub) account by ID. Use when you need to change details like email, phone, name, password, or activation status after account creation.
>
> #### Input Parameters
>
> **name** `string`
>
> New display name for the access account.
>
> **email** `string`
>
> New email address for the access account.
>
> **phone** `string`
>
> New phone number for the access account (E.164 format).
>
> **password** `string`
>
> New password for the access account; must follow strength policy.
>
> **is\_active** `integer ("0" | "1")`
>
> Activation flag: 1 to activate, 0 to deactivate.
>
> **access\_account\_id** `string` *required*
>
> The ID of the access account to update.
>
> #### 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 Caller ID
>
> **Slug:** `DIALMYCALLS_UPDATE_CALLER_ID`
>
> Tool to update an existing caller ID by ID. Use when you need to change its phone number or display name.
>
> #### Input Parameters
>
> **name** `string`
>
> New friendly name for the caller ID.
>
> **caller\_id** `string` *required*
>
> The unique identifier of the caller ID to update.
>
> **phone\_number** `string`
>
> New caller ID phone number in E.164 format (e.g., '+15551234567')
>
> #### 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
