Skip to main content
POST
/
manage-call-whitelist
curl -X POST https://api.magpipe.ai/functions/v1/manage-call-whitelist \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
    "caller_number": "+16045551234",
    "forward_to": "+16045559876",
    "label": "Kyler'\''s son"
  }'

{
  "entry": {
    "id": "a1b2c3d4-0000-0000-0000-000000000001",
    "caller_number": "+16045551234",
    "forward_to": "+16045559876",
    "label": "Kyler's son",
    "created_at": "2026-03-15T08:00:00Z"
  }
}
Creates a new whitelist entry. When an inbound call matches the caller_number, it is blind-forwarded to forward_to without invoking the AI agent. The call is still recorded and logged.

​
Request Body

​
agent_id
string
required
UUID of the agent to add the whitelist entry to.Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301
​
caller_number
string
required
The inbound caller number to match, in E.164 format.Example: +16045551234
​
forward_to
string
required
The destination phone number to forward the call to, in E.164 format.Example: +16045559876
​
label
string
Optional human-readable label for this entry.Example: Kyler's son

​
Response

Returns the created whitelist entry on success (201 Created).
​
entry
object
The created whitelist entry.
curl -X POST https://api.magpipe.ai/functions/v1/manage-call-whitelist \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
    "caller_number": "+16045551234",
    "forward_to": "+16045559876",
    "label": "Kyler'\''s son"
  }'

{
  "entry": {
    "id": "a1b2c3d4-0000-0000-0000-000000000001",
    "caller_number": "+16045551234",
    "forward_to": "+16045559876",
    "label": "Kyler's son",
    "created_at": "2026-03-15T08:00:00Z"
  }
}