> ## 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 number

> Add an SMS/MMS-enabled number to a Powerpack number pool

This API lets you add SMS- and MMS-enabled numbers to a number pool resource via Plivo’s SMS service.

#### API Endpoint

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

### Arguments

<table><tbody><tr><td><strong>service</strong></td><td><p>Set this parameter to `sms` for SMS-enabled numbers or `mms` for MMS-enabled numbers.</p><p>Defaults to sms.</p></td></tr></tbody></table>

### Returns

Returns a JSON response containing the added number resource detail.

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

  client = plivo.RestClient('<auth_id>','<auth_token>')
  powerpack = client.powerpacks.get(uuid="powerpack_uuid")
  print str(powerpack.add_number('your-number'))
  ```

  ```ruby Ruby theme={null}
  require 'rubygems'
  require 'plivo'
  include Plivo
  include Plivo::Exceptions

  api = RestClient.new("<auth_id>","<auth_token>")
  begin
    powerpack = api.powerpacks.get(uuid='powerpack_uuid')
    puts powerpack
    response = powerpack.add_number(number='your_number')
    puts response
  rescue PlivoRESTError => e
    puts 'Exception: ' + e.message
  end
  ```

  ```js Node theme={null}
  var plivo = require('plivo');
  var client = new plivo.Client("<auth_id>","<auth_token>");

  client.powerpacks.get("powerpack_uuid")
      .then(function (powerpack) {
        return powerpack.add_number("<your_number>")
      })
      .then(function (result) {
          console.log(result)
      })
      .catch(function (response) {
          console.log(response);
      });
  ```

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

  $client = new RestClient("<auth_id>","<auth_token>");
  $client->client->setTimeout(40);
  try {
      $powerpack = $client->powerpacks->get("your-powerpack-uuid");
      $response = $powerpack->add_number('your_number');
      print_r($response);
  }
  catch (PlivoRestException $ex) {
      print_r($ex);
  }
  ```

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

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

  public class PowerpackTest {
    public static void main(String[] args) {
      Plivo.init("<auth_id>", "<auth_token>");
      try {
        Powerpack powerpack = Powerpack.getter("powerpack_uuid").get();
        Numbers response = powerpack.add_number().number("<your_number>").get();
        System.out.println(response);
      }
      catch (  PlivoRestException | IOException e ) {
        e.printStackTrace();
      }
    }
  }
  ```

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

  namespace test_apps
  {
      class Program
      {
          static void Main(string[] args)
          {
              var api = new PlivoApi("<auth_id>","<auth_token>");
              try
              {
                  var response = api.Powerpacks.Get("powerpack_uuid");
                  Console.WriteLine(response.Add_Number("<your_number>"));
              }
              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
  	}
  	powerpack, err := client.Powerpack.Get("powerpack_uuid")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	// Add SMS Number
  	sms_response, err := powerpack.Add_number("<sms_number>")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	fmt.Printf("Response: %#v\n", sms_response)

  	// Add MMS Number
  	mms_response, err := powerpack.AddNumberWithOptions("<mms_number>", plivo.PowerpackAddNumberOptions{Service: "mms"})
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	fmt.Printf("Response: %#v\n", mms_response)
  }
  ```

  ```sh cURL theme={null}
  curl -X POST -i --user auth_id:auth_token \
  -H "Content-Type: application/json" \
  https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Number/{number}
  ```
</RequestExample>

### Response

```json theme={null}
{
    "account_phone_number_resource": "/v1/Account/<auth_id>/Number/<your_number>/",
    "added_on": "2022-10-09T11:24:35.085797Z",
    "api_id": "612982e8-0a87-11ea-b072-0242ac110007",
    "country_iso2": "CA",
    "number": "<your_number>",
    "number_pool_uuid": "<number_pool_uuid>",
    "service": "mms",
    "type": "fixed"
}
```