NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Dialmycalls connects to a Nagent workspace with an API key. Once it is connected, agents can call 25 Dialmycalls actions, such as "Add Access Account", "Add Contact" and "Add Group". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Dialmycalls, with input parameters and output schema.
DIALMYCALLS_ADD_ACCESS_ACCOUNTTool 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
The name of the access (sub) account to create.
Email address for the new access (sub) account.
Password for the new access (sub) account; follow strong password policy.
Optional list of permissions to assign. Eg: \['CALL_CREATE','VIEW_REPORTS'\]. If omitted, default permissions apply.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_ADD_CONTACTTool 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
The email address of the contact.
The phone number of the contact.
The unique identifier of the group to which the contact should be added.
The last name of the contact.
The first name of the contact.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_ADD_GROUPTool to add a new contact group. Use after deciding the group name to organize recipients into groups.
Input parameters
Name of the group to create. Must be non-empty.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_DELETE_ACCESS_ACCOUNTTool to delete an access (sub) account by ID. Use when removing a sub account after deprovisioning.
Input parameters
The ID or UUID of the access (sub) account to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_DELETE_CALLER_IDTool to delete a caller ID. Use when you need to permanently remove an existing caller ID no longer in use.
Input parameters
The unique identifier of the caller ID to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_DELETE_CONTACTTool to delete a contact by ID. Use when you need to permanently remove a contact from your list.
Input parameters
The unique identifier of the contact to delete (path parameter)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_DELETE_GROUPTool to delete a contact group by ID. Use when you need to remove an existing contact group after confirming its ID.
Input parameters
The unique identifier (UUID) of the group to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_DELETE_RECORDINGTool to delete a recording by ID. Use when you need to permanently remove a custom recording after confirming its recording ID.
Input parameters
The ID of the recording to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_ACCESS_ACCOUNTTool to retrieve an access (sub) account by ID. Use when you need to inspect the details of a specific sub-account.
Input parameters
The ID of the access (sub) account to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_ACCOUNTTool to retrieve your main account details. Use when you need to confirm account ID, remaining credits, and status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_CALLER_IDTool to retrieve a caller ID by ID. Use when you need its details such as phone number and verification status.
Input parameters
The unique identifier of the caller ID to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_CONTACTTool to retrieve a contact by its unique ID. Use when you need to fetch details of a specific contact from your account.
Input parameters
The unique identifier (UUID) of the contact to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_GROUPTool to retrieve a contact group by ID. Use when you need to fetch group details after creating or updating a group.
Input parameters
The ID of the group to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_GET_RECORDINGTool to retrieve a recording by ID. Use when you need details and file URL of an existing recording.
Input parameters
The unique identifier of the recording to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_ACCESS_ACCOUNTSTool to list all access (sub) accounts. Use when you need to retrieve paginated sub-account information for administration or reporting.
Input parameters
Page number for paginated results (default: 1).
Number of results per page (default: 20).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_CALLER_I_DSTool to list all caller IDs on the account. Use when you need to enumerate existing caller IDs before performing other operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_CALLSTool 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
Field to sort by.
Type of voice broadcast to filter.
Number of records to return (max 1000).
Sort order.
Record offset for pagination.
Status of the broadcast to filter.
Search filter for the call name.
Filter broadcasts created on or before this date (YYYY-MM-DD).
Filter broadcasts created on or after this date (YYYY-MM-DD).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_CONTACTSTool 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
Maximum number of contacts to return.
Zero-based index to start returning contacts from.
Keyword to filter contacts by name, phone, or email.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_DO_NOT_CONTACTSTool 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
Filter entries by type: 'phone' or 'email'.
Number of records to return (default 10, max 1000).
Number of records to skip for pagination (default 0).
Search term to filter matching phone numbers or emails.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_GROUPSTool to list all contact groups. Use when you need an overview of existing groups before sending messages.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_RECORDINGSTool to list all recordings. Use when you need to retrieve your account's recordings for auditing or bulk management.
Input parameters
Page number of results to retrieve (first page is 1)
Number of results per page (default is 10, max is 100)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_TEXTSTool to list all outgoing text broadcasts. Use when you need to review past text broadcasts with filters for date, status, and pagination.
Input parameters
Filter texts created before this date (YYYY-MM-DD).
Number of results to return per page (default 10 if not set, max 100).
Filter texts created after this date (YYYY-MM-DD).
Number of items to skip before starting to collect the result set.
Filter texts by status (e.g., 'sent', 'queued', 'failed').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_LIST_VANITY_NUMBERSTool to list all vanity numbers. Use when you need to retrieve available vanity phone numbers with pagination support.
Input parameters
Number of records to return per page (max 100).
Record offset for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_UPDATE_ACCESS_ACCOUNTTool 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
New display name for the access account.
New email address for the access account.
New phone number for the access account (E.164 format).
New password for the access account; must follow strength policy.
Activation flag: 1 to activate, 0 to deactivate.
The ID of the access account to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
DIALMYCALLS_UPDATE_CALLER_IDTool to update an existing caller ID by ID. Use when you need to change its phone number or display name.
Input parameters
New friendly name for the caller ID.
The unique identifier of the caller ID to update.
New caller ID phone number in E.164 format (e.g., '+15551234567')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 25 Dialmycalls actions on Nagent, including "Add Access Account", "Add Contact" and "Add Group". Add Access Account: Add a new access (sub) account. Each action is listed on this page with its input parameters and its output.
Dialmycalls connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Access Account takes 3 required inputs: name, email and password. It also takes 1 optional input: permissions. It returns data, error and successful.