> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Dialpad

> **This Connector is in Beta**
>
> Merge has validated Dialpad against the provider's documented API and not yet verified it against the live one, so its behavior can differ from the documentation. It carries the same tool surface it will have at general availability. [Connectors overview](/merge-agent-handler/connectors/overview) covers the tier and how to turn Beta Connectors off.

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List the members of the `Sales` call center
* Send an SMS from the support line to `+1 415 555 0134`
* Schedule a message to the `#support` channel for 9am tomorrow

## Available Tools

#### add_channel_member

Add a user to a Dialpad channel. Use list_channels to find channel IDs and list_users to find user IDs. Inverse of re...

#### create_callcenter

Create a Dialpad call center. name and office_id are required; use list_offices to find office_id. Returns the new ca...

#### create_channel

Create a Dialpad channel. name, description, and privacy_type ('public' or 'private') are required. Returns the new c...

#### create_contact

Create a Dialpad contact. first_name and last_name are required. Returns the new contact including its id for use wit...

#### create_department

Create a Dialpad department. name and office_id are required; use list_offices to find office_id. Returns the new dep...

#### create_room

Create a Dialpad room. name and office_id are required; use list_offices to find office_id. Returns the new room incl...

#### create_scheduled_message

Schedule a real Dialpad SMS/MMS; send_at is ISO 8601, at least 10 minutes ahead. Links go in text; file_reference is...

#### create_text_export

Start a batch text-history export (not real-time; real-time needs webhooks). Texts sent today may not appear yet. Exp...

#### create_user

Create a Dialpad user. email and office_id are required; use list_offices to find office_id. Returns the new user inc...

#### delete_callcenter

Delete a Dialpad call center by ID. Use list_callcenters to find call center IDs.

#### delete_channel

Delete a Dialpad channel by ID. Use list_channels to find channel IDs.

#### delete_contact

Delete a Dialpad contact by ID. Use list_contacts to find contact IDs.

#### delete_department

Delete a Dialpad department by ID. Use list_departments to find department IDs.

#### delete_number

Unassign/delete a Dialpad phone number by its E.164 string, e.g. '+14155550001'. Use list_numbers to find numbers.

#### delete_room

Delete a Dialpad room by ID. Use list_rooms to find room IDs.

#### delete_scheduled_message

Delete a Dialpad scheduled message by its string ID.

#### delete_user

Delete a Dialpad user by ID. Use list_users to find user IDs.

#### get_callcenter

Get a Dialpad call center by ID. Use list_callcenters to find call center IDs.

#### get_channel

Get a Dialpad channel by ID. Use list_channels to find channel IDs.

#### get_company

Get the Dialpad company associated with the current credential. Use this to discover the company ID needed by list_sm...

#### get_contact

Get a Dialpad contact by ID. Use list_contacts to find contact IDs.

#### get_department

Get a Dialpad department by ID. Use list_departments to find department IDs.

#### get_number

Get a Dialpad phone number by its E.164 string, e.g. '+14155550001'. Use list_numbers to find numbers. The number its...

#### get_office

Get a Dialpad office by ID. Use list_offices to find office IDs.

#### get_room

Get a Dialpad room by ID. Use list_rooms to find room IDs.

#### get_scheduled_message

Get one Dialpad scheduled message by its string ID.

#### get_text_export

Read a batch text-history export (not real-time; real-time needs webhooks). Texts sent today may not appear yet. Expo...

#### get_user

Get a Dialpad user by ID. Use list_users or search_users to find user IDs.

#### list_call_labels

List the call label names configured for the company. Returns a bare list of label strings with no pagination.

#### list_callcenters

List Dialpad call centers. Filter by office_id or name_search; set include_alerts for alert config. Use cursor + limi...

#### list_channel_members

List members of a Dialpad channel. Use list_channels to find channel IDs. Use cursor + limit for pagination.

#### list_channels

List Dialpad channels. Filter by state. Use cursor + limit for pagination.

#### list_contacts

List Dialpad contacts. Filter by name (first/last/display/company) or owner_id. Use cursor + limit for pagination; pa...

#### list_departments

List Dialpad departments. Filter by office_id or name_search. Use cursor + limit for pagination. Use list_offices to...

#### list_numbers

List Dialpad phone numbers. Filter by area_code or status ('office', 'available', 'pending', 'suspended'). Use cursor...

#### list_offices

List Dialpad offices. Set active_only to return only active offices. Use cursor + limit for pagination. Offices are r...

#### list_rooms

List Dialpad rooms. Filter by office_id. Use cursor + limit for pagination. Use list_offices to find office_id values.

#### list_scheduled_messages

List Dialpad scheduled messages. Use cursor and limit to paginate; use user_id to filter by owner.

#### list_sms_opt_outs

List SMS opt-out records for a Dialpad company. Use get_company to find company_id. This endpoint requires a company...

#### list_users

List Dialpad users. Filter by first_name, last_name, state, email, company_admin, number, or forwarding_number. Use c...

#### remove_channel_member

Remove a user from a Dialpad channel. Use list_channel_members to find member user IDs. Inverse of add_channel_member.

#### search_users

Search Dialpad users by a free-text query matched against name and email. Use this when you have a search term; use l...

#### send_scheduled_message_now

Send a Dialpad scheduled message immediately instead of waiting for its scheduled time.

#### send_sms

Send a real SMS/MMS in Dialpad. Links go in text; file_reference is one image or video (max 500 KiB raw). Dialpad rej...

#### update_callcenter

Update a Dialpad call center by ID. Only the fields you set are changed. Use list_callcenters to find call center IDs.

#### update_contact

Update a Dialpad contact by ID. Only the fields you set are changed. Use list_contacts to find contact IDs.

#### update_department

Update a Dialpad department by ID. Only the fields you set are changed. Use list_departments to find department IDs.

#### update_room

Update a Dialpad room by ID. Only the fields you set are changed. Use list_rooms to find room IDs.

#### update_scheduled_message

Update only the fields provided for a Dialpad scheduled message. send_at is ISO 8601 and must be at least 10 minutes...

#### update_user

Update a Dialpad user by ID. Only the fields you set are changed. Use list_offices to find office_id values. Use list...