> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dialpad

> Manage contacts, users, and SMS in Dialpad

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `offline_access`.
* **Docs**: [https://developers.dialpad.com/docs/oauth](https://developers.dialpad.com/docs/oauth)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                | Required | Description                                                                    |
| ----------------------- | -------- | ------------------------------------------------------------------------------ |
| `DIALPAD_CLIENT_ID`     | Yes      | Dialpad OAuth Client ID [Docs](https://developers.dialpad.com/docs/oauth).     |
| `DIALPAD_CLIENT_SECRET` | Yes      | Dialpad OAuth Client Secret [Docs](https://developers.dialpad.com/docs/oauth). |

## Setup

1. **Request an OAuth app**: Dialpad OAuth clients are issued by Dialpad: contact [api@dialpad.com](mailto:api@dialpad.com) (or your Dialpad account manager) to register an OAuth app with your redirect URI \<your-app-url>/api/auth/dialpad/callback and the scopes you need (request offline\_access for refresh tokens). See [https://developers.dialpad.com/docs/oauth](https://developers.dialpad.com/docs/oauth).
2. **Use the sandbox for testing**: Dialpad provides a free developer sandbox at [https://sandbox.dialpad.com](https://sandbox.dialpad.com) (see [https://developers.dialpad.com/docs/sandbox](https://developers.dialpad.com/docs/sandbox)). Sandbox OAuth uses [https://sandbox.dialpad.com/oauth2/authorize](https://sandbox.dialpad.com/oauth2/authorize) and /oauth2/token.
3. **Set credentials**: Add DIALPAD\_CLIENT\_ID and DIALPAD\_CLIENT\_SECRET to your .env.
4. **Verify access**: Complete the OAuth flow, then run the List Contacts tool.

* Refresh tokens are only issued when the offline\_access scope is requested and approved for your app
* Scopes must be approved by Dialpad when the OAuth app is registered
* This connector targets production (dialpad.com); point your OAuth app at the sandbox host for sandbox testing

Provider API reference: [https://developers.dialpad.com/docs/oauth](https://developers.dialpad.com/docs/oauth)

## Tools

| Tool           | Access | Description                                             |
| -------------- | ------ | ------------------------------------------------------- |
| List Contacts  | Read   | List Dialpad contacts visible to the authenticated user |
| Get Contact    | Read   | Get details of a Dialpad contact                        |
| Create Contact | Write  | Create a new contact in Dialpad                         |
| Update Contact | Write  | Update an existing Dialpad contact                      |
| List Users     | Read   | List Dialpad users in the company                       |
| Send SMS       | Write  | Send an SMS message on behalf of a Dialpad user         |

## Example prompts

* Search my Dialpad contacts for a person and show their phone numbers and emails.
* Send an SMS from my Dialpad number to a contact with a short message.