Skip to main content
POST
/
v1
/
numbers
/
link
cURL
curl --request POST \
  --url https://api.fluents.ai/v1/numbers/link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+1234567890",
  "telephony_account_connection": "550e8400-e29b-41d4-a716-446655440000",
  "outbound_only": true,
  "inbound_agent": "Agent Name"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "number": "+1234567890",
  "example_context": {},
  "active": true,
  "label": "My Phone Number",
  "inbound_agent_name": "Agent Name",
  "outbound_only": false,
  "telephony_provider": "twilio",
  "description": "Business line for customer service",
  "inbound_agent": "agent_123",
  "telephony_account_connection": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
phone_number
string
required
Example:

"+1234567890"

​
telephony_account_connection
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
outbound_only
boolean
Example:

true

​
inbound_agent
object
Example:

"Agent Name"

Response

​
id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
user_id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
number
string
required
Example:

"+1234567890"

​
example_context
object
required
​
active
boolean
Example:

true

​
label
string
Example:

"My Phone Number"

​
inbound_agent_name
string
Example:

"Agent Name"

​
outbound_only
boolean
Example:

false

​
telephony_provider
object
Example:

"twilio"

​
description
string
Example:

"Business line for customer service"

​
inbound_agent
object
Example:

"agent_123"

​
telephony_account_connection
object
Example:

"550e8400-e29b-41d4-a716-446655440000"