Look up agent by phone number

GET

/webhooks/lookup-agent/{phoneNumber}

Resolves a phone number to its active agent configuration, including the agent's tools and owning tenant. Used internally by the voice worker to determine which agent to load for a call.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Responses

🟢200

application/json

Active agent found for the number.

Bodyapplication/json

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/webhooks/lookup-agent/+4721000000' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Success

{
    "agent": {
        "id": "agt_123",
        "name": "Example AS Support",
        "phone_number": "+4721000000",
        "is_active": true,
        "tools": [],
        "tenant": {
            "id": "ten_789",
            "name": "Example AS"
        }
    }
}

Modified at 2026-07-08 19:01:40

Agent call-ended notification

Log a tool call from the agent