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

# Dub

> What agents can do in Dub with standard access, and how to connect, limit, and disconnect Dub.

Connect Dub so your agents can work in your Dub account.

## Access levels

Dub has one level. The connect window shows it as **Default** and describes it as "Standard access." Agents can use all 17 Dub actions.

You cannot choose a narrower level for Dub. You can block single agents with **No access** under **Per-agent access**.

The Dub sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in, and standard access does not limit which Dub actions agents can use.

## What agents can do

The summary below groups the Dub actions into plain tasks. The full list after it names every action, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.

<Tip>**Find an action.** Open the list and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Dub account?" The agent can search the Dub actions for you.</Tip>

Each action shows its name, a one-line description where the Dub action catalog has one, and its slug. The slug is the ID that agents use when they call the action.

* View, create, update, and delete short links
* View, create, update, and delete domains
* View, create, update, and delete tags
* View and update workspaces

<AccordionGroup>
  <Accordion title="All 17 Dub actions">
    | Works on          | Action            | What it does                                                        | Slug                    |
    | ----------------- | ----------------- | ------------------------------------------------------------------- | ----------------------- |
    | **Domains**       | Create domain     | Add a domain to a Dub workspace.                                    | `DUB_CREATE_DOMAIN`     |
    |                   | Delete domain     | Delete a domain from your Dub workspace.                            | `DUB_DELETE_DOMAIN`     |
    |                   | List domains      | Retrieve a list of domains for the authenticated workspace.         | `DUB_LIST_DOMAINS`      |
    |                   | Update domain     | Update a domain configuration in Dub.                               | `DUB_UPDATE_DOMAIN`     |
    | **Short links**   | Bulk delete links | Delete multiple short links in bulk from Dub.                       | `DUB_BULK_DELETE_LINKS` |
    |                   | Bulk update links | Update multiple short links in bulk.                                | `DUB_BULK_UPDATE_LINKS` |
    |                   | Get link info     | Retrieve details of a specific short link from Dub.                 | `DUB_GET_LINK_INFO`     |
    |                   | Get links         | Retrieve a paginated list of links for the authenticated workspace. | `DUB_GET_LINKS`         |
    |                   | Get links count   | Retrieve the count of links in workspace with optional filters.     | `DUB_GET_LINKS_COUNT`   |
    |                   | Upsert link       | Create or update a short link in Dub.                               | `DUB_UPSERT_LINK`       |
    | **Tags**          | Create tag        | Create a new tag in Dub.                                            | `DUB_CREATE_TAG`        |
    |                   | Delete tag        | Delete a tag from Dub.                                              | `DUB_DELETE_TAG`        |
    |                   | Get tags          | Retrieve a list of tags from Dub.                                   | `DUB_GET_TAGS`          |
    |                   | Update tag        | Update an existing tag by ID.                                       | `DUB_UPDATE_TAG`        |
    | **Workspaces**    | Get workspace     | Retrieve detailed information for a specific workspace.             | `DUB_GET_WORKSPACE`     |
    |                   | Update workspace  | Update workspace settings in Dub.                                   | `DUB_UPDATE_WORKSPACE`  |
    | **Other actions** | Track open        | Track a deep link open event in Dub.                                | `DUB_TRACK_OPEN`        |
  </Accordion>
</AccordionGroup>

## Connect Dub

Before you start:

* You need a Dub account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.

<Steps>
  <Step title="Open Integrations">
    Open **Settings** > **Integrations**.
  </Step>

  <Step title="Add an integration">
    On the **Connected apps** tab, click **+ Add integration**.
  </Step>

  <Step title="Find Dub">
    Find **Dub** in the catalog and click it. You can type the name in **Search the catalog…**.
  </Step>

  <Step title="Keep the default level">
    Under **Default scope**, keep **Default**. It is the only option.
  </Step>

  <Step title="Click Connect Dub">
    Click **Connect Dub**. The Dub sign-in page opens in a new tab.
  </Step>

  <Step title="Sign in to Dub">
    Sign in to Dub and approve the request.
  </Step>
</Steps>

Check that it works: Dub shows under **YOUR CONNECTIONS**, with a row for the account and its access level.

## Set access for one agent

Every agent can use the account unless you block it.

1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Dub account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose **No access** to block the agent. Choose **Default (Default)** to allow it again.
5. Click **Save access**.

Changes apply from the agent's next call. An agent with **No access** does not see the account.

## Use more than one Dub account

Click **+ Account** on the Dub card to connect another account. Agents use the primary account unless they are asked to use a specific one.

* After you click **+ Account**, follow the connect steps above.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.

## Reconnect or disconnect

Reconnect when the connection has expired, or when you need to change what the account can reach on the Dub side:

1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Dub**.
3. Sign in to Dub and approve the request.

Reconnect signs in to the same account again. It does not add a second connection.

Open the account menu (⋯) on the Dub account and click **Disconnect**. Agents lose access to that account at once.

<Warning>**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Dub account becomes primary.</Warning>

## Costs

Dub actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).

## Troubleshooting

An agent says it has no access to Dub, or it does not see the account.

* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.

Connecting or saving fails with "Your subscription isn't active."

* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).

An agent says the Dub connection has expired.

* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.

## Common questions

<AccordionGroup>
  <Accordion title="Can I limit what agents can do in Dub?">
    You cannot choose a narrower level for Dub. You can block single agents with **No access** under **Per-agent access**.
  </Accordion>

  <Accordion title="Can I connect more than one Dub account?">
    Click **+ Account** on the Dub card to connect another account. Agents use the primary account unless they are asked to use a specific one.
  </Accordion>

  <Accordion title="How do I disconnect Dub?">
    Open the account menu (⋯) on the Dub account and click **Disconnect**. Agents lose access to that account at once.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Connect apps" icon="plug" href="/docs/integrations" />

  <Card title="Add an MCP server or an API key" icon="server" href="/docs/custom-integrations">
    Use this when an action you need is not in this app.
  </Card>
</CardGroup>