10DLC - How to Cancel a campaign?

10DLC campaigns can be cancelled in several ways, read this article for more details.

First, a few things to understand about 10DLC campaigns:

• Any subscription paid into a campaign is non-refundable
• Any cancellation or request to cancel a campaign is final and cannot be reversed
• There are several ways by which a campaign can be cancelled:
  • The customer requests the cancellation requesting to stop the auto-renewal of the campaign
    In this instance, the campaign remains active until the end of the paid subscription.
  • The customer requests to immediately cancel the campaign
    In this instance, any subscription paid into the campaign will be lost.
  • The campaign is terminated due to a violation of 10DLC's T&Cs
    In this instance, the campaign appears as "Terminated" and any subscription paid will be lost. A description should explain why the campaign was terminated.

Using the Customer Dashboard

When visiting our customer dashboard

1. Go into a specific Brand and Navigate to the Campaign you wish to cancel. Then click on the "Unsubscribe" button

2. Click the either "Cancel campaign now" or "Cancel at the end of the billing period"

Using the Public API

Before January 2023

The endpoint to request the cancellation of a 10DLC campaign was:

DELETE https://api-eu.vonage.com/v1/10dlc/brands/:brand_id/campaigns/:campaign_id
{}

This endpoint was setting the 10DLC campaign attribute 'auto-renewal' to FALSE.

This results in the campaign remaining ACTIVE until the end of the paid subscription.

This action cannot be reversed.

This endpoint will be deprecated in the near future

After January 2023

The new process to cancel a 10DLC campaign is more aligned with the RESTful standards

There are now two options to cancel the campaign:

• To cancel the campaign at the end of the billing period

PATCH https://api-eu.vonage.com/v1/10dlc/brands/:brand_id/campaigns/:campaign_id
{
  ...
  "auto_renewal": false,
  ...
}

This results in the campaign remaining ACTIVE until the end of the paid subscription.

This action cannot be reversed.

• To cancel the campaign immediately

PATCHhttps://api-eu.vonage.com/v1/10dlc/brands/:brand_id/campaigns/:campaign_id
{
  ...
  "status": "CANCELED"
  ...
}

The only values accepted when setting the status are "CANCELED" and "CANCELLED".

This results in the immediate termination of the campaign, all subscription paid will be lost.

This action cannot be reversed.