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

# Add a toll-free number

> Add a toll-free number to a Powerpack number pool

This API lets you add existing SMS- and MMS-enabled toll-free numbers to a number pool.

#### API Endpoint

```text POST theme={null}
https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Tollfree/{toll_free_number}/
```

### Arguments

<Note>
  No arguments need to be passed.
</Note>

### Returns

Returns a JSON response containing the added toll-free number resource detail.

<RequestExample>
  ```py Python theme={null}
  import plivo

  client = plivo.RestClient(auth_id="<auth_id>", auth_token="<auth_token>")
  # Add Tollfree to a Powerpack
  powerpack = client.powerpacks.get(uuid='<powerpack_uuid>')
  # Version 1
  response = powerpack.add_tollfree('<tollfree_number>')
  # Version 2
  response = powerpack.numberpool.tollfree.add('<tollfree_number>')
  print(response)
  ```

  ```ruby Ruby theme={null}
  require 'rubygems'
  require 'plivo'

  include Plivo
  include Plivo::Exceptions

  api = RestClient.new("<auth_id>", "<auth_token>")

  begin
  # Add a Tollfree Number
  powerpack = api.powerpacks.get('<powerpack_uuid>')
  # Version 1
  response = powerpack.add_tollfree('<tollfree_number>')
  # Version 2
  response = powerpack.numberpool.tollfree.add('<tollfree_number>')

  puts(response)
  rescue PlivoRESTError => e
  puts 'Exception: ' + e.message
  end
  ```

  ```js Node theme={null}
  let plivo = require('plivo');

  let client = new plivo.Client('<auth_id>', '<auth_token>');

  // Add Tollfree to a Powerpack
  client.powerpacks.get("<powerpack_uuid>").then(
    function (powerpack) {
      return powerpack.add_tollfree("<tollfree>")
      //return powerpack.number_pool.tollfree.add("<tollfree>");  V2
    })
  .then(function (result) {
    console.log(result)
  })
  ```

  ```php PHP theme={null}
  <?php
  require 'vendor/autoload.php';
  use Plivo\RestClient;

  $client = new RestClient("<auth_id>", "<auth_token>");
  $client->client->setTimeout(40);

   // Add a TollFree to Powerpack
      try {
      $powerpack = $client->powerpacks->get($powerpack_uuid);
      // Version 1
      $response = $powerpack->add_tollfree($tollfree_number);
      // Version 2 
      $response = $powerpack->number_pool->tollfree->add($tollfree_number);
      print_r($response);
      }
      catch (PlivoRestException $ex) {
          print_r($ex);
      }
  ```

  ```java Java theme={null}
  package com.plivo.api;

  import java.io.IOException;
  import com.plivo.api.Plivo;
  import com.plivo.api.exceptions.PlivoRestException;
  import com.plivo.api.models.powerpack.Powerpack;
  import com.plivo.api.models.powerpack.Tollfree;

  public class Test {
      public static void main(String[] args) {
              
          Plivo.init("<auth_id>", "<auth_token>");

          // Add Tollfree to Powerpack
          try {
              Powerpack powerpack = Powerpack.getter("<powerpack_uuid>").get();
              // Version 1
              Tollfree response = powerpack.add_tollfree().tollfree("<tollfree>").get();
              //Version 2
              Tollfree response = powerpack.numberpool.tollfree.add().tollfree("<tollfree>").get();
          } catch (PlivoRestException | IOException e) {
              e.printStackTrace();
          }
      }
  }
  ```

  ```csharp .NET theme={null}
  using System;
  using System.Collections.Generic;
  using Plivo;
  using Plivo.Exception;

  namespace PlivoExamples
  {
      class Program
      {
          static void Main(string[] args)
          {
              var api = new PlivoApi("<auth_id>","<auth_token>");

              // Add Tollfree to Powerpack
              try
              {   
                  var powerpack = api.Powerpacks.Get("<powerpack_uuid>");
                  // Version 1
                  // var response = powerpack.Add_Tollfree("<tollfree_number>");
                  // Version 2
                  var response = powerpack.numberpool.tollfree.Add("<tollfree_number>");
                  Console.WriteLine(response);
              }
              catch (PlivoRestException e)
              {
                  Console.WriteLine("Exception: " + e.Message);
              }
          }
      }
  }
  ```

  ```go Go theme={null}
  package main

  import (
  	"fmt"

  	plivo "github.com/plivo/plivo-go/v7"
  )

  func main() {

  	client, err := plivo.NewClient("<auth_id>", "<auth_token>",
  		&plivo.ClientOptions{})
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}

  	// Add Tollfree to Powerpack
  	powerpack, err := client.Powerpack.Get("<powerpack_uuid>")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	response, err := powerpack.Add_tollfree("<tollfree_number>")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	fmt.Printf("Response: %#v\n", response)
  }
  ```

  ```sh cURL theme={null}
  ```
</RequestExample>

### Response

```json theme={null}
{
    "account_phone_number_resource": "/v1/Account/<auth_id>/Number/<your_toll_free_number>/",
    "added_on": "2021-04-15T04:49:51.228392Z",
    "api_id": "8a6bba9c-7ed4-11ea-b82e-0242ac110006",
    "country_iso2": "US",
    "number": "<your_toll_free_number>",
    "number_pool_uuid": "<number_pool_uuid>",
    "service": "mms",
    "type": "tollfree"
}
```