Dialmycalls

Learn how to use Dialmycalls with Composio

Overview

SLUG: DIALMYCALLS

Description

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

Authentication Details

generic_api_key
stringRequired

Connecting to Dialmycalls

Create an auth config

Use the dashboard to create an auth config for the Dialmycalls toolkit. This allows you to connect multiple Dialmycalls accounts to Composio for agents to use.

1

Select App

Navigate to the Dialmycalls toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4dialmycalls_auth_config_id = "ac_YOUR_DIALMYCALLS_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": user_api_key}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Dialmycalls for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, dialmycalls_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Dialmycalls toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DIALMYCALLS"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add Access Account

Description

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.

Action Parameters

email
Required
name
stringRequired
password
stringRequired
permissions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add Contact

Description

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.

Action Parameters

email
string
first_name
string
group_id
string
last_name
string
phone
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add Group

Description

Tool to add a new contact group. use after deciding the group name to organize recipients into groups.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Access Account

Description

Tool to delete an access (sub) account by id. use when removing a sub account after deprovisioning.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Caller ID

Description

Tool to delete a caller id. use when you need to permanently remove an existing caller id no longer in use.

Action Parameters

caller_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Contact

Description

Tool to delete a contact by id. use when you need to permanently remove a contact from your list.

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Group

Description

Tool to delete a contact group by id. use when you need to remove an existing contact group after confirming its id.

Action Parameters

group_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Recording

Description

Tool to delete a recording by id. use when you need to permanently remove a custom recording after confirming its recording id.

Action Parameters

recording_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Access Account

Description

Tool to retrieve an access (sub) account by id. use when you need to inspect the details of a specific sub-account.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Account

Description

Tool to retrieve your main account details. use when you need to confirm account id, remaining credits, and status.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Caller ID

Description

Tool to retrieve a caller id by id. use when you need its details such as phone number and verification status.

Action Parameters

caller_id
stringRequired

Action Response

data
objectRequired
error
string
message
stringRequired
status
stringRequired
successful
booleanRequired

Tool Name: Get Contact

Description

Tool to retrieve a contact by its unique id. use when you need to fetch details of a specific contact from your account.

Action Parameters

contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Group

Description

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

Action Parameters

group_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Recording

Description

Tool to retrieve a recording by id. use when you need details and file url of an existing recording.

Action Parameters

recording_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Access Accounts

Description

Tool to list all access (sub) accounts. use when you need to retrieve paginated sub-account information for administration or reporting.

Action Parameters

page
integerDefaults to 1
per_page
integerDefaults to 20

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Caller IDs

Description

Tool to list all caller ids on the account. use when you need to enumerate existing caller ids before performing other operations.

Action Parameters

Action Response

data
arrayRequired
error
string
message
stringRequired
success
booleanRequired
successful
booleanRequired

Tool Name: List Calls

Description

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.

Action Parameters

end_date
string
keyword
string
limit
integerDefaults to 100
offset
integer
order
stringDefaults to desc
sort
stringDefaults to id
start_date
string
status
string
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Contacts

Description

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

Action Parameters

limit
integer
offset
integer
search
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Contacts in Group

Description

Tool to list contacts by contact group id. use when you need to retrieve all contacts belonging to a specific group for management or reporting.

Action Parameters

group_id
stringRequired
limit
integerDefaults to 100
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Do Not Contacts

Description

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.

Action Parameters

limit
integerDefaults to 10
offset
integer
search
string
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Groups

Description

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

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Recordings

Description

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

Action Parameters

limit
integer
page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Text Broadcasts

Description

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

Action Parameters

end
string
limit
integer
offset
integer
start
string
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Vanity Numbers

Description

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

Action Parameters

limit
integer
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Access Account

Description

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.

Action Parameters

access_account_id
stringRequired
email
is_active
integer
name
string
password
string
phone
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Caller ID

Description

Tool to update an existing caller id by id. use when you need to change its phone number or display name.

Action Parameters

caller_id
stringRequired
name
string
phone_number

Action Response

data
objectRequired
error
string
successful
booleanRequired