Skip to main content
POST
/
v1
/
personas
/
{persona_id}
/
inbound
/
attach
Attach Phone Numbers to Persona
curl --request POST \
  --url https://api.bland.ai/v1/personas/{persona_id}/inbound/attach \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "inbound_numbers": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Support Agent",
    "user_id": "12345678-1234-1234-1234-123456789012",
    "inbound_numbers": [
      {
        "phone_number": "+14155551234",
        "label": "Support Line",
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "persona_settings": null
      },
      {
        "phone_number": "+14155555678",
        "label": null,
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "persona_settings": null
      }
    ],
    "created_at": "2025-09-23T15:13:36.348Z",
    "updated_at": "2025-09-23T15:13:36.412Z"
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
persona_id
string
required
The unique identifier of the persona to attach numbers to.

​
Body Parameters

​
inbound_numbers
string[]
required
Array of E.164 formatted phone numbers to attach to this persona. All numbers must already belong to your account.

​
Response

​
data
object
The updated persona object with the newly attached inbound numbers.
​
errors
null|array
null on success, or a list of error objects if the request failed.
{
  "data": {
    "id": "12345678-1234-1234-1234-123456789012",
    "name": "Support Agent",
    "user_id": "12345678-1234-1234-1234-123456789012",
    "inbound_numbers": [
      {
        "phone_number": "+14155551234",
        "label": "Support Line",
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "persona_settings": null
      },
      {
        "phone_number": "+14155555678",
        "label": null,
        "persona_id": "12345678-1234-1234-1234-123456789012",
        "persona_settings": null
      }
    ],
    "created_at": "2025-09-23T15:13:36.348Z",
    "updated_at": "2025-09-23T15:13:36.412Z"
  },
  "errors": null
}
Docs for agents: llms.txt