Look up customer context for a voice preview

Served by the standalone Voice API. Requires a Bearer session for a workspace owner/admin/manager when VOICE_AI_TELEPHONY_TURN_CONTROL_V2 is enabled. Legacy flag-off access is preserved. Existing route-specific validation still applies.

POST

https://api.channelautomation.com/api/workspaces/{workspaceId}/voice-ai/lookup-customer

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Path parameters

workspaceId
string
required

Request body JSON

phone
optional
string
Customer phone.
email
optional
string
Customer email.
lookup_mode
optional
string
Existing configured lookup mode.
query
optional
object
Lookup query overrides.
body
optional
object
Lookup request body overrides.

Returns

200

Successful operation

400

Invalid call or preview parameters

401

Missing or invalid session

403

Workspace owner/admin/manager required

404

Requested resource not found

409

Call is not in a state permitting this operation

500

Operation failed

503

Access verification or service unavailable

Look up customer context for a voice preview

curl --request POST \
  --url 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/lookup-customer' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "string",
  "email": "string",
  "lookup_mode": "string",
  "query": {},
  "body": {}
}
'

const url = 'https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/lookup-customer';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({phone: 'string', email: 'string', lookup_mode: 'string', query: {}, body: {}})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/workspaces/<workspaceId>/voice-ai/lookup-customer"

payload = {
    "phone": "string",
    "email": "string",
    "lookup_mode": "string",
    "query": {},
    "body": {}
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)