Skip to main content
Beta: This documentation is under active development. Join Discord for updates.
Two ways to integrate ToughTongue AI:

Iframe Embedding

Drop-in widget. Fastest integration—under 5 minutes.

REST API

Full programmatic control. Build custom workflows.

​
Quick Comparison

FeatureIframeAPI
Setup time5 min30+ min
Custom UILimitedFull control
Event handlingpostMessagePolling/Callback
Best forEmbedded practiceCustom platforms

​
Get Started

​
1. Get API Key

  1. Sign up at app.toughtongueai.com
  2. Go to Developer Portal → API Keys
  3. Create and save your token
Never expose API tokens in client-side code. Proxy through your backend.

​
2. Create a Scenario

Use Scenario Studio or the API: 
curl -X POST https://api.toughtongueai.com/api/public/scenarios \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sales Coach", "ai_instructions": "You are a skeptical VP..."}'

​
3. Choose Integration

Iframe — Embed directly: 
<iframe src="https://app.toughtongueai.com/embed/SCENARIO_ID" allow="microphone"></iframe>
API — Build custom: 
// Create session
const session = await fetch("/api/tough-tongue/sessions", {
  method: "POST",
  body: JSON.stringify({ scenario_id: "SCENARIO_ID" }),
}).then((r) => r.json());

// Redirect to session
window.location = session.embed_url;

​
Resources

Help: help@getarchieai.com