POST

Add Phone Numbers to Pool

Adds one or more owned phone numbers to the pool.

POSThttps://api.vantaxai.com/v1/number-pools/{pool_id}/members

Each phone number must belong to the same sub-account as the pool. Adding a number that is already a member is a no-op, so this endpoint is safe to retry.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Path Parameters

pool_idstringrequired
The pool to add numbers to.
example: pool_4c8e21

Body Parameters

phone_number_idsstring[]required
Ids of the owned phone numbers to add to the pool.
example: ["pn_55ad12", "pn_77be34"]

Request

curl -X POST https://api.vantaxai.com/v1/number-pools/pool_4c8e21/members \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_ids": ["pn_55ad12", "pn_77be34"]
  }'

const res = await fetch(
  "https://api.vantaxai.com/v1/number-pools/pool_4c8e21/members",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer vx_live_3fa9c2...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone_number_ids: ["pn_55ad12", "pn_77be34"] }),
  }
);
const { data: pool } = await res.json();

const pool = await vantax.numberPools.addMembers("pool_4c8e21", {
  phoneNumberIds: ["pn_55ad12", "pn_77be34"],
});

pool = vantax.number_pools.add_members(
    "pool_4c8e21",
    phone_number_ids=["pn_55ad12", "pn_77be34"],
)

Response

{
  "success": true,
  "message": "Phone numbers added to pool",
  "data": {
    "id": "pool_4c8e21",
    "member_count": 2,
    "members": [
      {
        "id": "mem_91ad0c",
        "phone_number_id": "pn_55ad12",
        "number": "+14155550142",
        "source": "platform",
        "created_at": "2026-01-16T11:00:00Z"
      },
      {
        "id": "mem_7b22f4",
        "phone_number_id": "pn_77be34",
        "number": "+14155550199",
        "source": "twilio",
        "created_at": "2026-01-16T11:00:00Z"
      }
    ]
  }
}

{
  "success": false,
  "message": "Phone number not found in this sub-account"
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "phone_number_ids", "message": "phone_number_ids must contain at least one id" }
  ]
}