Add a Number
This API enables you to add SMS/MMS enabled numbers to a numberpool resource via Plivo’s SMS service.
API Endpoint
POST
https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Number/{number}/
Arguments
serviceOptional |
Set this parameter either assms for SMS-enabled numbers or as mms for MMS-enabled numbers. Defaults to sms. |
Returns
Returns a JSON response containing the added number resource detail.
Response
HTTP Status Code: 200
{
"account_phone_number_resource": "/v1/Account/<auth_id>/Number/<your_number>/",
"added_on": "2019-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"
}
Example Request
1
2
3
4
5
6
| 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'))
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| 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
|
1
2
3
4
5
6
7
8
9
10
11
12
13
| 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);
});
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| <?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);
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| 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();
}
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| 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);
}
}
}
}
|
1
2
3
| 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}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
| package main
import (
"fmt"
plivo "github.com/plivo/plivo-go"
)
func main() {
client, err := plivo.NewClient("auth_id", "auth_token", &plivo.ClientOptions{})
if err != nil {
panic(err)
}
powerpack, err := client.Powerpack.Get("powerpack_uuid")
if err != nil {
panic(err)
}
// Add SMS Number
sms_response, err := powerpack.Add_number("<sms_number>")
if err != nil {
panic(err)
}
fmt.Printf("Response: %#v\n", sms_response)
// Add MMS Number
mms_response, err := powerpack.AddNumberWithOptions("<mms_number>", plivo.PowerpackAddNumberOptions{Service: "mms"})
if err != nil {
panic(err)
}
fmt.Printf("Response: %#v\n", mms_response)
}
|
Example Request
1
2
3
4
5
6
| 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'))
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| 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
|
1
2
3
4
5
6
7
8
9
10
11
12
13
| 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);
});
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
| <?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);
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| 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();
}
}
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
| 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);
}
}
}
}
|
1
2
3
| 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}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
| package main
import (
"fmt"
plivo "github.com/plivo/plivo-go"
)
func main() {
client, err := plivo.NewClient("auth_id", "auth_token", &plivo.ClientOptions{})
if err != nil {
panic(err)
}
powerpack, err := client.Powerpack.Get("powerpack_uuid")
if err != nil {
panic(err)
}
// Add SMS Number
sms_response, err := powerpack.Add_number("<sms_number>")
if err != nil {
panic(err)
}
fmt.Printf("Response: %#v\n", sms_response)
// Add MMS Number
mms_response, err := powerpack.AddNumberWithOptions("<mms_number>", plivo.PowerpackAddNumberOptions{Service: "mms"})
if err != nil {
panic(err)
}
fmt.Printf("Response: %#v\n", mms_response)
}
|
🥳 Thank you! It means a lot to us!
Help Us Improve
Thank you so much for rating the page, we would like to get your input
for further improvements!
Thank you for your feedback!