ElevenLabs tool: lookup contact by phone number

Server tool webhook called by the ElevenLabs voice agent mid-call to look up a contact by phone number within the calling organization. Authenticated via Bearer token (per-org elevenlabsToolSecret).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Tool args for contact lookup. Either phone_number or caller_id should be set.

phone_number?string

Phone number to look up (E.164 preferred); takes precedence over caller_id.

caller_id?string

Fallback caller phone number when phone_number is not supplied by the agent.

called_id?string

Tether AI-enabled number that was called; used to scope the lookup to the right org.

conversation_id?string

ElevenLabs conversation id used to correlate with cached call context.

[key: string]?any

Response Body

`application/json`

curl -X POST "https://example.com/api/webhook/elevenlabs/tools/get-contact" \  -H "Content-Type: application/json" \  -d '{    "phone_number": "+14165550100",    "caller_id": "+14165550100",    "called_id": "+12362320246",    "conversation_id": "conv_8f3d1b9c2e7a4f0b9a4d2c1e6e2f8c01"  }'

{  "found": true,  "contact_name": "Alex Morgan",  "phone_number": "+14165550100",  "email": "alex@example.com",  "status": "active"}

ElevenLabs tool: lookup contact by phone number

Request Body

Response Body

200application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`