# Dialmycalls

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

- **Category:** communication
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `DIALMYCALLS`
- **Version:** 20260227_00

## Tools

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the access (sub) account to create. |
| `email` | string | Yes | Email address for the new access (sub) account. |
| `password` | string | Yes | Password for the new access (sub) account; follow strong password policy. |
| `permissions` | array | No | Optional list of permissions to assign. Eg: ['CALL_CREATE','VIEW_REPORTS']. If omitted, default permissions apply. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | The email address of the contact. |
| `phone` | string | Yes | The phone number of the contact. |
| `group_id` | string | No | The unique identifier of the group to which the contact should be added. |
| `last_name` | string | No | The last name of the contact. |
| `first_name` | string | No | The first name of 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the group to create. Must be non-empty. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID or UUID of the access (sub) account 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `caller_id` | string | Yes | The unique identifier of the caller ID 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | The unique identifier of the contact to delete (path parameter) |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier (UUID) of the group 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `recording_id` | string | Yes | The ID of the recording 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the access (sub) account 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 |

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

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `caller_id` | string | Yes | The unique identifier of the caller ID 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | The unique identifier (UUID) of the contact 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 |

### Get Group

**Slug:** `DIALMYCALLS_GET_GROUP`

Tool to retrieve a contact group by ID. Use when you need to fetch group details after creating or updating a group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The ID of the group 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 |

### Get Recording

**Slug:** `DIALMYCALLS_GET_RECORDING`

Tool to retrieve a recording by ID. Use when you need details and file URL of an existing recording.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `recording_id` | string | Yes | The unique identifier of the recording 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results (default: 1). |
| `per_page` | integer | No | Number of results per page (default: 20). |

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

**Slug:** `DIALMYCALLS_LIST_CALLER_I_DS`

Tool to list all caller IDs on the account. Use when you need to enumerate existing caller IDs before performing other 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 |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("id" | "created") | No | Field to sort by. |
| `type` | string ("normal" | "survey" | "poll" | "reminder") | No | Type of voice broadcast to filter. |
| `limit` | integer | No | Number of records to return (max 1000). |
| `order` | string ("asc" | "desc") | No | Sort order. |
| `offset` | integer | No | Record offset for pagination. |
| `status` | string ("draft" | "sent" | "scheduled" | "stopped") | No | Status of the broadcast to filter. |
| `keyword` | string | No | Search filter for the call name. |
| `end_date` | string | No | Filter broadcasts created on or before this date (YYYY-MM-DD). |
| `start_date` | string | No | Filter broadcasts created on or after this date (YYYY-MM-DD). |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of contacts to return. |
| `offset` | integer | No | Zero-based index to start returning contacts from. |
| `search` | string | No | Keyword to filter contacts by name, phone, or email. |

#### 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 Do Not Contacts

**Slug:** `DIALMYCALLS_LIST_DO_NOT_CONTACTS`

Tool to list all Do Not Contact entries. Use when you need to review or manage blocked phone numbers or emails in your account. Supports pagination and filtering by type and search.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("phone" | "email") | No | Filter entries by type: 'phone' or 'email'. |
| `limit` | integer | No | Number of records to return (default 10, max 1000). |
| `offset` | integer | No | Number of records to skip for pagination (default 0). |
| `search` | string | No | Search term to filter matching phone numbers or emails. |

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

**Slug:** `DIALMYCALLS_LIST_GROUPS`

Tool to list all contact groups. Use when you need an overview of existing groups before sending messages.

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

**Slug:** `DIALMYCALLS_LIST_RECORDINGS`

Tool to list all recordings. Use when you need to retrieve your account's recordings for auditing or bulk management.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of results to retrieve (first page is 1) |
| `limit` | integer | No | Number of results per page (default is 10, max is 100) |

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

**Slug:** `DIALMYCALLS_LIST_TEXTS`

Tool to list all outgoing text broadcasts. Use when you need to review past text broadcasts with filters for date, status, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end` | string | No | Filter texts created before this date (YYYY-MM-DD). |
| `limit` | integer | No | Number of results to return per page (default 10 if not set, max 100). |
| `start` | string | No | Filter texts created after this date (YYYY-MM-DD). |
| `offset` | integer | No | Number of items to skip before starting to collect the result set. |
| `status` | string | No | Filter texts by status (e.g., 'sent', 'queued', 'failed'). |

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

**Slug:** `DIALMYCALLS_LIST_VANITY_NUMBERS`

Tool to list all vanity numbers. Use when you need to retrieve available vanity phone numbers with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of records to return per page (max 100). |
| `offset` | integer | No | Record offset for pagination. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New display name for the access account. |
| `email` | string | No | New email address for the access account. |
| `phone` | string | No | New phone number for the access account (E.164 format). |
| `password` | string | No | New password for the access account; must follow strength policy. |
| `is_active` | integer ("0" | "1") | No | Activation flag: 1 to activate, 0 to deactivate. |
| `access_account_id` | string | Yes | The ID of the access account to update. |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New friendly name for the caller ID. |
| `caller_id` | string | Yes | The unique identifier of the caller ID to update. |
| `phone_number` | string | No | New caller ID phone number in E.164 format (e.g., '+15551234567') |

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