Use the Vyora API key and webhooks

Generate your API key

1. Open Settings and go to the Integrations tab.
2. Under API key, click Generate key.
3. Copy the key straight away and store it safely. It starts with vya_live_.

Only the workspace owner can generate or revoke the key. Others see "Only the workspace owner can generate an API key."

The full key is shown only once. After you leave the page, Settings shows only the start of the key followed by dots. That masked text is not your key and will not work. If you lost the key, click the bin icon (Revoke key), then generate a new one. Anything using the old key stops working immediately.

Place a call

All requests go to https://api.vyora.ai/v1 with your key in the X-API-KEY header. Full reference: API documentation.

1. GET /v1/agents lists your agents and their ids.
2. GET /v1/numbers lists the caller numbers for your workspace and their ids.
3. POST /v1/calls places a call:

curl -X POST https://api.vyora.ai/v1/calls \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+919876543210","agent_id":"YOUR_AGENT_ID","from_number_id":"YOUR_NUMBER_ID"}'

1. GET /v1/calls/<call_id> returns the status, transcript, recording and analysis once the call is processed.

Requests per minute

Get call results by webhook

1. In Settings, Integrations tab, under Webhook, enter your Endpoint URL and click Save.
2. Click Send test. You should see Delivered.
3. Copy the Signing secret that appears and use it to check the X-Vyora-Signature header (an HMAC-SHA256 of the raw body).

Vyora sends one POST per call, with the event call_completed, after the recording and analysis are ready. Your server must reply with a 200 within 5 seconds.

Common errors

"Invalid API key" when the key looks right

• You copied the masked key. Only the key shown at the moment you generated it works.
• A new key was generated. Each workspace has one key. Generating a new one replaces the old one.
• Extra characters. Check for spaces or a line break around the key. Do not add "Bearer" in front.
• Wrong workspace. If you belong to more than one workspace, each has its own key, agents and numbers.

"From numbers not found"

This came from the calling network when the number id did not match the line your workspace dials from. Vyora now picks the right line for any id that GET /v1/numbers gives you. Call GET /v1/numbers again with your key and use the id it returns. If you still see this error, raise a ticket with your workspace name and the request time.