Add a number to a pool

add a single owned number to a pool. Idempotent.

POST https://api.centerfy.ai/webhooks/inbound/number-pools/:id/numbers

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your sub-account API key (cfy_…)	API key; or Authorization: Bearer `<key>`.
`Content-Type`	Yes	application/json	request body is JSON.

Path parameters

Name	Type	Required	Description
`id`	`string (uuid)`	Yes	the number pool id; 404 otherwise.

Body parameters

Name	Type	Required	Default	Description
`phone_number_id`	`string`	Yes	—	UUID of the phone number to add. Must be a valid UUID (400 otherwise) and a phone number you own (404 otherwise).

Request body

{
  "phone_number_id": "<phone_number_id>"
}

Example

curl -X POST "https://api.centerfy.ai/webhooks/inbound/number-pools/{id}/numbers" \
  -H "x-api-key: $CENTERFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_number_id": "<phone_number_id>"
}'

import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.numberPools.addNumber("<poolId>", {
  "phone_number_id": "<phone_number_id>"
});
console.log(result);

centerfy numberPools add-number <poolId> '{"phone_number_id":"<phone_number_id>"}'

MCP tool: centerfy_number_pools_add_number (see MCP server)

Response

{
  "status": "success",
  "added": true,
  "number_pool_id": "3f1c9a2e-5b6d-4e8a-9c1f-2a3b4c5d6e7f",
  "phone_number_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "phone_number": "+14155550123"
}

Errors

400 — invalid pool id or phone_number_id.
404 — pool or phone number not found.
401 — missing or invalid key.

Notes

Targeted counterpart to the set-based PATCH. Returns 201 on a new add. Idempotent: if the number is already in the pool it returns 200 with already_in_pool:true and adds nothing.