What causes "D-ID Agent Not Working (Embed or Stream Connection Failed)"?

Your website domain isn't in the Agent's allowed domains list Embed code pasted in the wrong place or stripped by the site builder SDP answer or ICE candidates sent with a wrong stream/session ID Too many stream requests (429 rate limit) Out of streaming minutes (402) Corporate network or firewall blocking WebRTC

How do I fix "D-ID Agent Not Working (Embed or Stream Connection Failed)"?

1. Fix the allowed domains: In D-ID Studio open the Agents tab and hover the Agent Click ⋯ > Embed Add every domain the Agent runs on, e.g. https://www.yourwebsite.com and the non-www version Copy the new embed code and replace the old snippet in your site's HTML 2. Check the streaming calls: Log the HTTP status of create stream, SDP answer and ICE calls Pass the same stream ID and session_id returned by create stream to every follow-up call On 429, back off and avoid creating a new stream on every page load 3. Check credits and network: A 402 means no streaming minutes left: check your balance or upgrade Test on another network; strict firewalls and VPNs can block WebRTC Refresh the page to retry an intermittent ICE failure

// troubleshooting guide · d-id

D-ID Agent Not Working (Embed or Stream Connection Failed)

Status: Ongoing
platforms:: Web, API
updated:: November 15, 2026
reports:: 5
Method: how we research

RUNBOOK · d-id/agent-not-working3 FIXES

// quick answer

A D-ID Agent that won't load on your site is usually a domain missing from the embed allow-list; a stream that connects and then fails is usually a WebRTC/ICE problem, rate limiting (429) or no credits (402). Fix the allowed domains, check the HTTP codes and retry.

Most likely fix: Fix the allowed domains

How to fix it

// try these in order, the most common fix is first

FIX 1Fix the allowed domains
1. 01In D-ID Studio open the Agents tab and hover the Agent
2. 02Click ⋯ > </> Embed
3. 03Add every domain the Agent runs on, e.g. https://www.yourwebsite.com and the non-www version
4. 04Copy the new embed code and replace the old snippet in your site's HTML
Did this fix it?
FIX 2Check the streaming calls
1. 01Log the HTTP status of create stream, SDP answer and ICE calls
2. 02Pass the same stream ID and session_id returned by create stream to every follow-up call
3. 03On 429, back off and avoid creating a new stream on every page load
Did this fix it?
FIX 3Check credits and network
1. 01A 402 means no streaming minutes left: check your balance or upgrade
2. 02Test on another network; strict firewalls and VPNs can block WebRTC
3. 03Refresh the page to retry an intermittent ICE failure
Did this fix it?

Symptoms

The embedded Agent doesn't appear or stays blank, the video stream never starts, the connection state goes to failed, or the API returns 400/402/429 or "Missing or invalid session_id".