Introduction

You can now allocate dedicated numbers for specific purposes with Plivo’s enhanced support for number masking through sub-accounts. Previously, to leverage the number masking feature across various use cases—such as Customer-Delivery Agent Interaction, Customer-Support Interaction, Seller-Buyer Interaction, etc.— users were required to create multiple Plivo accounts.

This new capability eliminates the need for creating and managing multiple Plivo accounts, thereby saving you both time and effort. Here’s how to make the most of Plivo’s number masking feature using sub-accounts.

Using Sub-accounts with Number Masking

Plivo customers who need dedicated numbers for multiple number masking purposes can now utilize sub-accounts. Simply assign numbers to the sub-accounts you wish to use and initiate masking sessions through the steps below. Plivo will automatically manage the virtual number allocation for these sessions.

  1. Create a sub-account through the Plivo console or API.
  2. Rent and link numbers to the sub-account in the console or using Plivo’s API.
  3. Initiate a number masking session using the sub-account auth. You’re all set!

Plivo will exclusively use the numbers associated with the sub-account for virtual number allocation in number masking.

Using Sub-accounts with Number Masking

Sample “create session” request

The following request will create a number masking session with the virtual number that belongs to the sub-account auth ’SAOWRKMGU3YZCTZJXXX’.

curl -X POST "https://api.plivo.com/v1/Account/{Auth ID}/Masking/Session" \
-H "Content-Type: application/json" \
-d '{
  "first_party": "+919003459XXX",
  "second_party": "+919840037XXX",
  "is_pin_authentication_required": true,
  "first_party_pin": 1234,
  "second_party_pin": 4321,
  "pin_prompt_play": "https://play.s3.eu-north-1.amazonaws.com/pin_prompt.wav",
  "geomatch": true,
  "subaccount": "SAOWRKMGU3YZCTZJXXX",
  "incorrect_pin_play": "https://play.s3.eu-north-1.amazonaws.com/incorrect_pin.wav"
}
'