What events are available?

session.created, call.incoming, call.connected, call.ended, call.missed and session.expired. Each carries your reference, the virtual number, caller and callee, direction and timestamp; call.ended adds duration_sec.

How are webhooks secured?

When you set a secret, each delivery is signed with HMAC-SHA256 over the raw body and sent in the X-Edesy-Signature header as sha256= .

What about failed deliveries?

Event delivery is best-effort: each event is sent once with a 5-second timeout and is not retried automatically. Every attempt appears in the delivery log, and you can reconcile from GET /v1/masking/call-logs.

Can I have multiple webhook endpoints?

One event-webhook endpoint per account. Fan out to other systems from your own receiver. Routing webhooks are set per number.

What is the routing webhook?

For numbers in webhook mode, Edesy POSTs a masking.route request when a call arrives and connects or rejects the call based on your reply. Your endpoint must answer within 5 seconds; fallback_internal decides what happens if it doesn't.

Can I pause deliveries?

Yes. Set enabled to false on PUT /v1/masking/event-webhook to pause without deleting the config.

Integration

Number Masking Webhooks

Q: What does it cost?

Rs 1.50 per minute of bridged call time in 60-second pulses, 1-minute minimum, plus number rental (Rs 499/month mobile, Rs 449/month landline). Prices exclude 18% GST. New accounts get a Rs 20 welcome credit; no card needed to sign up.

Number masking event webhooks: one HTTPS endpoint receives session.created, call.incoming, call.connected, call.ended, call.missed and session.expired, signed with HMAC-SHA256. Plus a routing webhook that lets your server pick the target of each call.

Get Started

View All Integrations

Quick Start

Receive your first event

Step 1 of 4: Register your endpoint
PUT /v1/masking/event-webhook with your HTTPS url and a signing secret, or set it in the portal under Settings.
Step 2 of 4: Send a test
POST /v1/masking/event-webhook/test sends a synthetic session.created event and shows the status code and latency.
Step 3 of 4: Verify the signature
Recompute HMAC-SHA256 over the raw body with your secret and compare with X-Edesy-Signature (sha256=<hex>).
Step 4 of 4: Respond fast
Return a 2xx within 5 seconds and do heavy work asynchronously.

Set Up and Payload

# Point lifecycle events at one HTTPS endpoint
curl -X PUT https://voice-api.edesy.in/v1/masking/event-webhook \
  -H "Authorization: Bearer $EDESY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://api.yourapp.com/edesy/events","secret":"whsec_change_me"}'

# Send a synthetic session.created event to check your receiver
curl -X POST https://voice-api.edesy.in/v1/masking/event-webhook/test \
  -H "Authorization: Bearer $EDESY_API_KEY"

# What we POST (header X-Edesy-Signature: sha256=<hex HMAC of the raw body>)
{
  "event": "call.ended",
  "reference": "ORD-4821",
  "virtual_number": "918071387146",
  "caller": "9876543210",
  "callee": "9123456789",
  "direction": "a_to_b",
  "call_sid": "d28be7cd-9840-4b23-9627-199f1ef81fc6",
  "duration_sec": 92,
  "status": "completed",
  "timestamp": "2026-07-14T18:05:00Z"
}

Capabilities

Lifecycle events

session.created, call.incoming, call.connected, call.ended, call.missed and session.expired.

Signed payloads

HMAC-SHA256 over the raw body, sent as sha256=<hex> in X-Edesy-Signature.

Delivery log

GET /v1/masking/event-webhook/deliveries lists recent attempts with status code, success and error.

Routing webhook

Set a number to webhook mode and Edesy asks your server, per call, which number to connect (masking.route).

Simple Per-Minute Pricing

Rs 1.50/min in 60-second pulses, 1-minute minimum, plus number rental (Rs 499/month mobile, Rs 449/month landline). Prices exclude 18% GST. New accounts get a Rs 20 welcome credit; no card needed to sign up.

Ready to Protect User Privacy?

Get started on the self-serve portal. Rs 1.50 per minute plus number rental. New accounts get a Rs 20 welcome credit; no card needed to sign up.

Go to Portal Contact Sales