POST

api

platform

telephony

bridges

{slug}

connect-provider

Connect Provider to Bridge

curl --request POST \
  --url https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Org-Handle: <org-handle>' \
  --data '
{
  "provider_config_id": 42,
  "phone_number": "+1234567890"
}
'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/"

payload = {
    "provider_config_id": 42,
    "phone_number": "+1234567890"
}
headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Org-Handle': '<org-handle>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({provider_config_id: 42, phone_number: '+1234567890'})
};

fetch('https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider_config_id' => 42,
    'phone_number' => '+1234567890'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/"

	payload := strings.NewReader("{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}"

response = http.request(request)
puts response.read_body

{
  "status_code": 200,
  "message": "Provider connected to bridge successfully.",
  "data": {
    "message": "Provider connected successfully",
    "bridge_slug": "sales-bridge-001",
    "phone_number": "+1234567890"
  }
}

{
  "status_code": 400,
  "message": "Failed to connect provider.",
  "errors": "Provider configuration not found or phone number invalid"
}

{
  "status_code": 200,
  "message": "Provider connected to bridge successfully.",
  "data": {
    "message": "Provider connected successfully",
    "bridge_slug": "sales-bridge-001",
    "phone_number": "+1234567890"
  }
}

{
  "status_code": 400,
  "message": "Failed to connect provider.",
  "errors": "Provider configuration not found or phone number invalid"
}

Connect Provider to Bridge

Connect a telephony provider configuration to a specific bridge, linking a phone number to the bridge for call routing. This enables inbound and outbound calls through the connected provider.

Prerequisites: Make sure you have your API Token, Org-Handle, a configured Bridge, and a Provider Configuration ready. See Authentication for details.

The provider_config_id must be a valid provider configuration already created for your organization. You can only use a phone_number that is linked to the provider account.

Path Parameters

Name	Type	Required	Description
slug	string	Yes	Unique bridge slug

You can get the bridge slug by hitting the Get All Bridges API. The slug field in the response is your Bridge Slug.

Headers

Name	Type	Required	Description
Authorization	string	Yes	API Key format: `Token <token>`
Org-Handle	string	Yes	Organization domain handle
Content-Type	string	Yes	`application/json`

You can get the Org-Handle by hitting the Get All Organizations API. The domain_handle field in the response is your Org-Handle.

Request Body

Field	Type	Required	Description
provider_config_id	integer	Yes	ID of the provider configuration to connect
phone_number	string	Yes	Phone number (E.164 format) to assign to the bridge

Response Fields

Field	Type	Description
status_code	integer	HTTP status code
message	string	Response message
data	object	Connection result

Data Object Fields

Field	Type	Description
message	string	Success message
bridge_slug	string	The bridge slug the provider connected to
phone_number	string	The phone number assigned to the bridge

Common Error Codes

Status Code	Description
200	Success - Provider connected successfully
400	Bad Request - Invalid provider ID or phone number
401	Unauthorized - Invalid or missing API token
403	Forbidden - Invalid organization handle
404	Not Found - Bridge not found
500	Internal Server Error - Server-side error

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle',
  'Content-Type': 'application/json'
};

// Connect a provider to a bridge
const connectProviderToBridge = async (slug, providerConfigId, phoneNumber) => {
  const response = await axios.post(
    `https://unpod.ai/api/v2/platform/telephony/bridges/${slug}/connect-provider/`,
    { provider_config_id: providerConfigId, phone_number: phoneNumber },
    { headers }
  );
  console.log(`Provider connected to bridge: ${response.data.data.bridge_slug}`);
  console.log(`Phone number assigned: ${response.data.data.phone_number}`);
  return response.data.data;
};

// Example usage
connectProviderToBridge('sales-bridge-001', 42, '+1234567890');

import requests

headers = {
    'Authorization': 'Token your-api-token',
    'Org-Handle': 'your-org-handle',
    'Content-Type': 'application/json'
}

def connect_provider_to_bridge(slug: str, provider_config_id: int, phone_number: str):
    """Connect a provider configuration to a bridge"""
    url = f'https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/'
    payload = {
        'provider_config_id': provider_config_id,
        'phone_number': phone_number
    }
    response = requests.post(url, headers=headers, json=payload)
    data = response.json()
    print(f"Provider connected to bridge: {data['data']['bridge_slug']}")
    print(f"Phone number assigned: {data['data']['phone_number']}")
    return data['data']

# Example usage
connect_provider_to_bridge('sales-bridge-001', 42, '+1234567890')

# Connect a provider to a bridge
curl -X POST "https://unpod.ai/api/v2/platform/telephony/bridges/sales-bridge-001/connect-provider/" \
  -H "Authorization: Token your-api-token" \
  -H "Org-Handle: your-org-handle" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_config_id": 42,
    "phone_number": "+1234567890"
  }'

Best Practices

Provider Config ID: Get the correct provider_config_id from Get All Providers before connecting
Phone Number Format: Use E.164 format (e.g., +1234567890) for phone numbers
Verify Bridge: Confirm the bridge exists using Get Bridge by Slug before connecting
One Provider per Bridge: A bridge typically connects to one provider - verify current state before re-connecting
Error Handling: Handle 400 errors that may indicate an invalid phone number or provider config
Security: Keep API tokens secure and rotate them regularly

Authorizations

Authorization

string

header

required

Format: Token

Headers

Org-Handle

string

required

Organization domain handle

Example:

"unpod.tv"

Path Parameters

slug

string

required

Example:

"sales-bridge-001"

Body

application/json

provider_config_id

integer

required

Example:

42

phone_number

string

required

Example:

"+1234567890"

Response

Provider connected to bridge

Get Telephony NumbersRetrieve list of all telephony numbers

Connect Provider to Bridge

curl --request POST \
  --url https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Org-Handle: <org-handle>' \
  --data '
{
  "provider_config_id": 42,
  "phone_number": "+1234567890"
}
'

import requests

url = "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/"

payload = {
    "provider_config_id": 42,
    "phone_number": "+1234567890"
}
headers = {
    "Org-Handle": "<org-handle>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Org-Handle': '<org-handle>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({provider_config_id: 42, phone_number: '+1234567890'})
};

fetch('https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider_config_id' => 42,
    'phone_number' => '+1234567890'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "Org-Handle: <org-handle>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/"

	payload := strings.NewReader("{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Org-Handle", "<org-handle>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/")
  .header("Org-Handle", "<org-handle>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://unpod.ai/api/v2/platform/telephony/bridges/{slug}/connect-provider/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Org-Handle"] = '<org-handle>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider_config_id\": 42,\n  \"phone_number\": \"+1234567890\"\n}"

response = http.request(request)
puts response.read_body

{
  "status_code": 200,
  "message": "Provider connected to bridge successfully.",
  "data": {
    "message": "Provider connected successfully",
    "bridge_slug": "sales-bridge-001",
    "phone_number": "+1234567890"
  }
}

{
  "status_code": 400,
  "message": "Failed to connect provider.",
  "errors": "Provider configuration not found or phone number invalid"
}

Getting Started

API Lists

Connect Provider to Bridge

Connect Provider to Bridge

Path Parameters

Headers

Request Body

Response Fields

Data Object Fields

Common Error Codes

Code Examples

Best Practices

Authorizations

Headers

Path Parameters

Body

Response

​Connect Provider to Bridge

​Path Parameters

​Headers

​Request Body

​Response Fields

​Data Object Fields

​Common Error Codes

​Code Examples

​Best Practices

Authorizations

Headers

Path Parameters

Body

Response

Connect Provider to Bridge

Path Parameters

Headers

Request Body

Response Fields

Data Object Fields

Common Error Codes

Code Examples

Best Practices