Skip to main content
Questions we hear most from developers integrating with HeyMilo. For endpoint details, see the v2 API Overview. For webhook payloads and signing, see Webhooks. Don’t see your question? Email support@heymilo.ai and we’ll add it here.

​
Webhooks

How do I verify that a webhook came from HeyMilo? Webhooks created through the v2 or v4 endpoints are signed with HMAC-SHA256. The create response includes a signing_secret (it starts with whsec_). Each delivery carries an X-HeyMilo-Signature header with a timestamp and signature; recompute the signature with your secret and compare. See Verifying Webhook Signatures. Can I retrieve or rotate a webhook’s signing secret? No. The secret is returned once, in the create response, and never appears in get or list responses. If you lose it, delete the webhook and register a new one to get a fresh secret. Each webhook has its own secret. I registered a webhook before signing existed. Does it have a secret? No. Older registrations, and any created through the legacy POST /api/webhook/create endpoint, are delivered unsigned. Delete the webhook and re-create it through POST /api/v2/webhooks or POST /api/v4/webhooks to start receiving signed deliveries.

​
Interviews & results

The transcript shows “Interviewer Sara” but I set a different interviewer_name. Why? “Sara” in the transcript is a fixed display label. It isn’t read from your posting or step configuration, and the AI doesn’t use it. The AI introduces itself with the interviewer_name you set. If you rename your interviewer, update interviewer_name; the change applies to future interviews only, and past transcripts are unchanged.

​
Candidate experience

What does the “Don’t Interrupt Me” button do during a voice interview? It sends a mute or unmute signal to the voice provider, pausing or resuming the interviewer’s speech. It doesn’t change how the AI handles interruptions or turn-taking, so if the interviewer wasn’t speaking when the candidate clicked it, nothing visible happens. It can’t be configured or hidden through workspace or posting settings.