WoyraDocs
Get an API key

A voice provider's event webhook

POST/v1/voice/{provider}/{secret}

Voice · Requires an API key

Not for customers. The provider posts here as a call rings, answers, gathers digits and ends; the path secret authenticates it, compared in constant time. An incoming event is answered in the response body with the number's stored voice_instructions, or declined when it has none. A retried event is recognised and applied once.

Parameters

NameInDescription
providerrequiredpath
secretrequiredpath

Example

curl -X POST https://api.woyra.io/v1/voice/<provider>/<secret> \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 An incoming call — answered with instructions, or declined.