> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/whatsapp-calls/how-to-use-calling-license.md).

# How to use calling license

Assign, manage, and revoke DoubleTick calling licenses.

A Calling License is a permission-based access control feature in DoubleTick that lets specific team members use calling functionality on the platform. This article covers how to assign, remove, and manage licenses — both from the app and through the public API.

#### What's covered

* [Calling license basics](#what-is-a-calling-license)
* [What licensed team members can do](#what-can-a-team-member-do-with-a-calling-license)
* [Assign a calling license](#how-to-assign-a-calling-license)
* [Control calling access](#how-to-control-calling-access-through-roles)
* [Remove a calling license](#how-to-remove-a-calling-license)
* [Purchase more licenses](#how-to-purchase-additional-calling-licenses)
* [Manage licenses through the Public API](#how-to-assigning-or-revoking-a-calling-license-using-the-public-api)
* [API key permissions and limits](#api-key-permissions-and-usage-limits)
* [Key takeaways](#key-takeaways)
* [Frequently asked questions](#frequently-asked-questions)

#### What is a calling license

When you purchase the Calling Add-on for your DoubleTick account, you get **five calling licenses** by default. Each license can be assigned to one team member at a time. Only team members who've been assigned a calling license can perform any calling-related activity in DoubleTick — team members without one won't have access to WhatsApp Calling at all.

### What can a team member do with a calling license?

A calling license gives a team member access to WhatsApp Calling. Once assigned a license, they can:

* **Request permission to call**: Send calling consent templates to customers.
* **Make outgoing calls**: Place outbound WhatsApp calls to customers who have given consent.
* **Answer incoming calls**: Receive incoming WhatsApp calls.
* **View call history**: Access and review past call logs.

{% hint style="info" %}
**Note**: To make or answer calls, or complete any calling activity, a team member needs both a calling license and the required calling permissions. To learn which permissions a team member needs for these activities, see [How to set permissions for custom channel role](/settings/manage-roles/how-to-set-permissions-for-custom-channel-role.md).
{% endhint %}

#### How to assign a calling license

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FeJ2LtjY3xmtjRKganvRT%2FUntitled%20design%20-%202026-04-27T150012.449.gif?alt=media&#x26;token=34597dc0-6aba-4fea-b80f-1e009bb6787b" alt=""><figcaption></figcaption></figure>

You need an **Owner** organization role to manage calling licenses. A custom organization role also works when it includes **Assign Call License** or **Revoke Call License** permission.

Log in to DoubleTick and go to the **Team** section. Click the team member's name to whom you want to assign the license. Their **profile panel** will open on the right side of the screen. Scroll down below the **Login Number** field to find the **Calling License** option, and then click **Assign License**. The license is assigned to that team member immediately.

After assigning the license, click on **Manage Assigned Channels** on the same profile panel. Select the WABA number or numbers you want the team member to use for calling and save. If you have multiple WABA numbers, this step lets you control exactly which numbers each team member can call from.

#### **How to control calling access through roles**

Assigning a calling license gives a team member access to calling, but their **role and permissions** determine what they can do. DoubleTick provides four calling-related permissions in **channel role**:

* **Make Outgoing Calls** — Allows team members to make voice calls to customers from DoubleTick.
* **Receive Incoming Calls** — Allows team members to answer incoming calls from customers.
* **Configure Call Settings** — Allows team members to allocate and manage calling licenses for the WhatsApp channel. This permission is best suited for admins or team leads managing calling access.
* **View All Call Logs** — Allows team members to view call logs across the channel, including calls made by other team members.
* **View My Call Logs** — Allows team members to view their own call logs and the call logs of users who report to them.

Team members with an **Owner** or **Admin** role get the relevant calling permissions by default. If you want more control over what a team member can do, you can create a **custom role** and assign only the permissions they need. See [**How to set permissions for a custom channel role**](https://learn.doubletick.io/settings/manage-roles/understanding-the-permissions-available-while-creating-a-custom-channel-role#call-management-new) to learn more about setting up custom roles and permissions.

#### How to remove a calling license

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2Fsu2pEbF4H5GeirZnTT5x%2Fdownload%20(10).gif?alt=media&#x26;token=9cb9e62d-9e36-4c74-8cf4-33332eac44b4" alt=""><figcaption></figcaption></figure>

Go to the **Team** section and click on the team member's name. In their profile panel, scroll below the **Login Number** field and click **Manage Assigned Channels**. Find the WABA number whose calling license you want to remove and click the **trash icon** next to it. Once the license is removed, the team member will no longer have calling access.

#### How to purchase additional calling licenses

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F6HA5myaOVMnNqZM5zqCH%2FUntitled%20design%20-%202026-04-27T151315.270.gif?alt=media&#x26;token=b2c37cc0-752b-423d-b322-6617dc3bb8e7" alt=""><figcaption></figcaption></figure>

If five licenses aren't enough for your team, you can purchase more at any time.

* **Go to** Settings and navigate to **Billing and Invoices**.
* **Click** on **Purchase Add-ons**.
* **Find** the Calling License option, enter the number of additional licenses you need, and complete the payment.

Once the payment is processed, the licenses are credited to your account and you can begin assigning them immediately.

#### **How to assigning or revoking a calling license using the Public API**

You can assign or revoke a team member's calling license programmatically using the DoubleTick Public API. This is useful if you manage team members or calling access through your own system and want to automate these actions instead of doing them manually from the DoubleTick dashboard. You can use the team member's **login number** to identify the person whose calling license you want to assign or revoke.

**To assign a calling license**, use:

`POST /whatsapp/call/license/invoke`

This assigns a calling license to the team member associated with the login number provided in the request.

**To revoke a calling license**, use:

`POST /whatsapp/call/license/revoke`

This removes the calling license from the team member associated with the login number provided in the request.

Both endpoints use the same license management logic as the corresponding actions in the DoubleTick app, so the behavior remains consistent whether you manage calling licenses from the dashboard or through the API.

#### API key permissions and usage limits

Calling license API requests are limited to **60 requests per minute per organization and user**. If you are making multiple requests programmatically, make sure your application stays within this limit.

The API key you use to assign or revoke a calling license must be created by a team member who has the required permission in their **Organization Role**. If the API key is created by a team member who has the **Owner** organization role, they can use the API to assign or revoke calling licenses.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FCxS7XiHPCThZABuLXDdR%2Fimage.png?alt=media&amp;token=99f2b849-1803-4be3-b42d-b07e96ac30e2" alt=""><figcaption></figcaption></figure>

If API key is created by the team member who has a **Custom Organization Role**, the required permission must be enabled for their role:

* **Assign** a calling license
* **Revoke** a calling license

These permissions must be available to the **team member who creates the API key**. The API key can then be used for the corresponding action. Make sure the API key is created by the right team member before using it to assign or revoke calling licenses.

For the complete request format, parameters, and response details, see the relevant API documentation:

* [Assign Calling License API](https://docs.doubletick.io/reference/invoke-call-license)
* [Revoke Calling License API](https://docs.doubletick.io/reference/revoke-call-license)

#### Key takeaways

* A calling license gates all calling access — team members without one can't use WhatsApp Calling at all.
* Accounts start with five licenses; you can purchase more anytime from Billing and Invoices.
* A license alone isn't enough — the team member's role also needs the relevant calling permissions.
* You can now assign or revoke licenses through the public API, using the same logic as the in-app flow.
* API-based license changes need the Assign Call License or Revoke Call License permission and are capped at 60 requests/minute per org and user.

#### Frequently asked questions

<details>

<summary>Who can assign or remove calling licenses?</summary>

Owners and Admins can assign or remove calling licenses by default.\
Team members on a custom role need the Assign Call License or Revoke Call License permission to do this themselves.

</details>

<details>

<summary>A team member has a license but still can't make calls — why?</summary>

A calling license alone isn't enough.\
Their role also needs the relevant calling permissions — both the license and the permissions have to be in place together.

</details>

<details>

<summary>Can I assign or revoke calling licenses using the public API?</summary>

Yes.\
Use `POST /whatsapp/call/license/invoke` to assign a license or `POST /whatsapp/call/license/revoke` to revoke one, both by the team member's phone number.

</details>

<details>

<summary>Is there a limit to how many calling licenses I can have?</summary>

No.\
Accounts start with five licenses, and you can purchase additional ones anytime from Billing and Invoices — there's no upper cap.

</details>

<details>

<summary>What are the rate limits for the calling license APIs?</summary>

Both the invoke and revoke endpoints are limited to 60 requests per minute per organization and user.

</details>

<details>

<summary>When does a calling license become active?</summary>

The license becomes active immediately after you assign it.\
The team member can call once their role and channel assignments allow it.

</details>

<details>

<summary>Can I assign one calling license to multiple team members?</summary>

No.\
Each license can be assigned to one team member at a time. Remove it first, then assign it to another team member.

</details>

<details>

<summary>Can a licensed team member call from multiple WABA numbers?</summary>

Yes.\
Assign the required WABA numbers through **Manage Assigned Channels** in the team member's profile.

</details>

#### Related articles

* [Understanding Call Permissions for Business-Initiated Calls on DoubleTick](/whatsapp-calls/business-initiated-calling-on-doubletick-complete-guide/understanding-call-permissions-for-business-initiated-calls-on-doubletick.md)
* [How to Control the WhatsApp Call Button Visibility](/whatsapp-calls/how-to-control-the-whatsapp-call-button-visibility.md)
* [Incoming WhatsApp Calling API – Your Complete Guide](/whatsapp-calls/incoming-whatsapp-calling-api-your-complete-guide.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.doubletick.io/whatsapp-calls/how-to-use-calling-license.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.