{"id":"8651eefb-fb71-4ead-8595-9cb3e95f68c8","shortId":"Jqnk2X","kind":"skill","title":"telnyx-import-elevenlabs","tagline":">-","description":"# Import ElevenLabs Agents into Telnyx\n\nMigrate your ElevenLabs conversational AI agents to Telnyx in minutes. The import API pulls agent configurations directly from ElevenLabs using your API key and recreates them as Telnyx AI Assistants.\n\n**Interaction model**: Collect the user's Telnyx API key and ElevenLabs API key, store the ElevenLabs key as a Telnyx integration secret, run the import, then verify. Do NOT skip the secret-creation step — the import endpoint requires a secret reference, not a raw key.\n\n## What Gets Imported\n\n| Component | Imported? | Notes |\n|-----------|-----------|-------|\n| Instructions | Yes | Imported as-is |\n| Greeting / first message | Yes | Maps to assistant `greeting` |\n| Voice configuration | Yes | ElevenLabs voice ID and settings preserved |\n| Dynamic variables | Yes | Default values carried over |\n| Tools (hangup, transfer, webhook) | Yes | Tool definitions and configurations |\n| MCP Server integrations | Yes | Server URLs and tool mappings |\n| Call analysis / insights | Yes | Mapped to `insight_settings` |\n| Data retention preferences | Yes | Mapped to `privacy_settings` |\n| Knowledge base | **No** | Must be manually added post-import |\n| Secrets (API keys in tools) | **Partial** | Placeholder secrets created — you must re-enter values in the Telnyx portal |\n\n## Prerequisites\n\n1. **Telnyx API key** — get one at https://portal.telnyx.com/#/app/api-keys\n2. **ElevenLabs API key** — from your ElevenLabs dashboard (Profile → API Keys)\n3. Store the ElevenLabs API key as a Telnyx integration secret at https://portal.telnyx.com/#/app/integration-secrets\n\n## Step 1: Store Your ElevenLabs API Key as a Telnyx Secret\n\nBefore importing, store your ElevenLabs API key as an integration secret in Telnyx. Note the secret reference name (e.g., `elevenlabs_api_key`) — you'll use it in the import call.\n\nYou can create integration secrets via the Telnyx Portal under **Integration Secrets**, or via the API.\n\n## Step 2: Import All ElevenLabs Agents\n\nImport every conversational AI agent from your ElevenLabs account:\n\n### curl\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"provider\": \"elevenlabs\",\n  \"api_key_ref\": \"elevenlabs_api_key\"\n}' \\\n  \"https://api.telnyx.com/v2/ai/assistants/import\"\n```\n\n### Python\n\n```python\nimport os\nfrom telnyx import Telnyx\n\nclient = Telnyx(api_key=os.environ.get(\"TELNYX_API_KEY\"))\n\nassistants = client.ai.assistants.imports(\n    provider=\"elevenlabs\",\n    api_key_ref=\"elevenlabs_api_key\",\n)\n\nfor assistant in assistants.data:\n    print(f\"Imported: {assistant.name} (ID: {assistant.id})\")\n```\n\n### JavaScript\n\n```javascript\nimport Telnyx from 'telnyx';\n\nconst client = new Telnyx();\n\nconst assistants = await client.ai.assistants.imports({\n  provider: 'elevenlabs',\n  api_key_ref: 'elevenlabs_api_key',\n});\n\nfor (const assistant of assistants.data) {\n  console.log(`Imported: ${assistant.name} (ID: ${assistant.id})`);\n}\n```\n\n### Go\n\n```go\nassistants, err := client.AI.Assistants.Imports(context.TODO(), telnyx.AIAssistantImportsParams{\n    Provider:  telnyx.AIAssistantImportsParamsProviderElevenlabs,\n    APIKeyRef: \"elevenlabs_api_key\",\n})\nif err != nil {\n    panic(err.Error())\n}\nfor _, a := range assistants.Data {\n    fmt.Printf(\"Imported: %s (ID: %s)\\n\", a.Name, a.ID)\n}\n```\n\n### Java\n\n```java\nimport com.telnyx.sdk.models.ai.assistants.AssistantImportsParams;\nimport com.telnyx.sdk.models.ai.assistants.AssistantsList;\n\nAssistantImportsParams params = AssistantImportsParams.builder()\n    .provider(AssistantImportsParams.Provider.ELEVENLABS)\n    .apiKeyRef(\"elevenlabs_api_key\")\n    .build();\nAssistantsList assistants = client.ai().assistants().imports(params);\nassistants.getData().forEach(a ->\n    System.out.printf(\"Imported: %s (ID: %s)%n\", a.getName(), a.getId()));\n```\n\n### Ruby\n\n```ruby\nassistants = client.ai.assistants.imports(\n  provider: :elevenlabs,\n  api_key_ref: \"elevenlabs_api_key\"\n)\n\nassistants.data.each do |a|\n  puts \"Imported: #{a.name} (ID: #{a.id})\"\nend\n```\n\n## Step 2 (Alternative): Import Specific Agents\n\nTo import only certain agents, pass their ElevenLabs agent IDs in `import_ids`:\n\n### curl\n\n```bash\ncurl \\\n  -X POST \\\n  -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"provider\": \"elevenlabs\",\n  \"api_key_ref\": \"elevenlabs_api_key\",\n  \"import_ids\": [\"elevenlabs-agent-id-1\", \"elevenlabs-agent-id-2\"]\n}' \\\n  \"https://api.telnyx.com/v2/ai/assistants/import\"\n```\n\n### Python\n\n```python\nassistants = client.ai.assistants.imports(\n    provider=\"elevenlabs\",\n    api_key_ref=\"elevenlabs_api_key\",\n    import_ids=[\"elevenlabs-agent-id-1\", \"elevenlabs-agent-id-2\"],\n)\n```\n\n### JavaScript\n\n```javascript\nconst assistants = await client.ai.assistants.imports({\n  provider: 'elevenlabs',\n  api_key_ref: 'elevenlabs_api_key',\n  import_ids: ['elevenlabs-agent-id-1', 'elevenlabs-agent-id-2'],\n});\n```\n\n## Step 3: Verify the Import\n\nList your Telnyx assistants to confirm the import succeeded:\n\n### curl\n\n```bash\ncurl -H \"Authorization: Bearer $TELNYX_API_KEY\" \\\n  \"https://api.telnyx.com/v2/ai/assistants\"\n```\n\n### Python\n\n```python\nassistants = client.ai.assistants.list()\nfor a in assistants.data:\n    print(f\"{a.name} — {a.id} — imported: {a.import_metadata}\")\n```\n\n### JavaScript\n\n```javascript\nconst assistants = await client.ai.assistants.list();\nfor (const a of assistants.data) {\n  console.log(`${a.name} — ${a.id} — imported:`, a.import_metadata);\n}\n```\n\n## Step 4: Post-Import Checklist\n\nAfter importing, complete these manual steps:\n\n1. **Re-enter secrets** — Any API keys referenced by tools were imported as placeholders. Go to https://portal.telnyx.com/#/app/integration-secrets and supply the actual values.\n2. **Add knowledge bases** — Knowledge base content is not imported. Upload files or add URLs in the assistant's Knowledge Base settings.\n3. **Assign a phone number** — Connect a Telnyx phone number to your imported assistant to start receiving calls.\n4. **Test the assistant** — Use the Telnyx assistant testing API or make a test call to verify behavior.\n\n## Re-importing\n\nRunning the import again for the same ElevenLabs agents will **overwrite** the existing Telnyx copies with the latest configuration from ElevenLabs. This is useful for syncing changes during a gradual migration.\n\n## API Reference\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `provider` | string | Yes | Must be `\"elevenlabs\"` |\n| `api_key_ref` | string | Yes | Name of the Telnyx integration secret containing your ElevenLabs API key |\n| `import_ids` | array[string] | No | Specific ElevenLabs agent IDs to import. Omit to import all. |\n\nEndpoint: `POST https://api.telnyx.com/v2/ai/assistants/import`\n\nFull API docs: https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider","tags":["telnyx","import","elevenlabs","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk"],"capabilities":["skill","source-team-telnyx","skill-telnyx-import-elevenlabs","topic-agent-skills","topic-ai-coding-agent","topic-claude-code","topic-cpaas","topic-cursor","topic-iot","topic-llm","topic-sdk","topic-sip","topic-sms","topic-speech-to-text","topic-telephony"],"categories":["ai"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/team-telnyx/ai/telnyx-import-elevenlabs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add team-telnyx/ai","source_repo":"https://github.com/team-telnyx/ai","install_from":"skills.sh"}},"qualityScore":"0.533","qualityRationale":"deterministic score 0.53 from registry signals: · indexed on github topic:agent-skills · 167 github stars · SKILL.md body (6,886 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:54:45.657Z","embedding":null,"createdAt":"2026-04-18T22:06:29.424Z","updatedAt":"2026-04-22T12:54:45.657Z","lastSeenAt":"2026-04-22T12:54:45.657Z","tsv":"'/#/app/api-keys':195 '/#/app/integration-secrets':221,672 '/api-reference/assistants/import-assistants-from-external-provider':823 '/v2/ai/assistants':608 '/v2/ai/assistants/import':321,532,817 '1':186,223,524,551,577,653 '2':196,280,475,529,556,582,678 '3':207,584,700 '4':642,718 'a.getid':452 'a.getname':451 'a.id':419,472,620,637 'a.import':622,639 'a.name':418,470,619,636 'account':293 'actual':676 'ad':162 'add':679,691 'agent':7,15,24,284,289,479,484,488,522,527,549,554,575,580,747,805 'ai':14,38,288 'altern':476 'analysi':141 'api':22,31,47,51,167,188,198,205,211,227,238,253,278,303,313,317,332,336,342,346,374,378,401,433,459,463,502,512,516,539,543,565,569,604,659,727,770,782,796,819 'api.telnyx.com':320,531,607,816 'api.telnyx.com/v2/ai/assistants':606 'api.telnyx.com/v2/ai/assistants/import':319,530,815 'apikeyref':399,431 'application/json':309,508 'array':800 'as-i':95 'assign':701 'assist':39,104,338,349,369,382,392,437,439,455,535,560,591,611,627,695,713,721,725 'assistant.id':357,389 'assistant.name':355,387 'assistantimportsparam':426 'assistantimportsparams.builder':428 'assistantimportsparams.provider.elevenlabs':430 'assistants.data':351,384,411,616,634 'assistants.data.each':465 'assistants.getdata':442 'assistantslist':436 'author':300,499,601 'await':370,561,628 'base':157,681,683,698 'bash':295,494,598 'bearer':301,500,602 'behavior':735 'build':435 'call':140,262,717,732 'carri':120 'certain':483 'chang':765 'checklist':646 'client':330,365 'client.ai':438 'client.ai.assistants.imports':339,371,394,456,536,562 'client.ai.assistants.list':612,629 'collect':42 'com.telnyx.sdk.models.ai.assistants.assistantimportsparams':423 'com.telnyx.sdk.models.ai.assistants.assistantslist':425 'complet':649 'compon':89 'configur':25,107,130,757 'confirm':593 'connect':705 'console.log':385,635 'const':364,368,381,559,626,631 'contain':793 'content':307,506,684 'content-typ':306,505 'context.todo':395 'convers':13,287 'copi':753 'creat':174,265 'creation':73 'curl':294,296,493,495,597,599 'd':310,509 'dashboard':203 'data':148 'default':118 'definit':128 'descript':775 'developers.telnyx.com':822 'developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider':821 'direct':26 'doc':820 'dynam':115 'e.g':251 'elevenlab':4,6,12,28,50,55,109,197,202,210,226,237,252,283,292,312,316,341,345,373,377,400,432,458,462,487,511,515,521,526,538,542,548,553,564,568,574,579,746,759,781,795,804 'elevenlabs-agent-id':520,525,547,552,573,578 'end':473 'endpoint':77,813 'enter':179,656 'err':393,404 'err.error':407 'everi':286 'exist':751 'f':353,618 'field':772 'file':689 'first':99 'fmt.printf':412 'foreach':443 'full':818 'get':87,190 'go':390,391,668 'gradual':768 'greet':98,105 'h':299,305,498,504,600 'hangup':123 'id':111,356,388,415,448,471,489,492,519,523,528,546,550,555,572,576,581,799,806 'import':3,5,21,64,76,88,90,94,165,234,261,281,285,324,328,354,360,386,413,422,424,440,446,469,477,481,491,518,545,571,587,595,621,638,645,648,665,687,712,738,741,798,808,811 'insight':142,146 'instruct':92 'integr':60,133,216,242,266,273,791 'interact':40 'java':420,421 'javascript':358,359,557,558,624,625 'key':32,48,52,56,85,168,189,199,206,212,228,239,254,304,314,318,333,337,343,347,375,379,402,434,460,464,503,513,517,540,544,566,570,605,660,783,797 'knowledg':156,680,682,697 'latest':756 'list':588 'll':256 'make':729 'manual':161,651 'map':102,139,144,152 'mcp':131 'messag':100 'metadata':623,640 'migrat':10,769 'minut':19 'model':41 'must':159,176,779 'n':417,450 'name':250,787 'new':366 'nil':405 'note':91,246 'number':704,709 'omit':809 'one':191 'os':325 'os.environ.get':334 'overwrit':749 'panic':406 'param':427,441 'partial':171 'pass':485 'phone':703,708 'placehold':172,667 'portal':184,271 'portal.telnyx.com':194,220,671 'portal.telnyx.com/#/app/api-keys':193 'portal.telnyx.com/#/app/integration-secrets':219,670 'post':164,298,497,644,814 'post-import':163,643 'prefer':150 'prerequisit':185 'preserv':114 'print':352,617 'privaci':154 'profil':204 'provid':311,340,372,397,429,457,510,537,563,776 'pull':23 'put':468 'python':322,323,533,534,609,610 'rang':410 'raw':84 're':178,655,737 're-ent':177,654 're-import':736 'receiv':716 'recreat':34 'ref':315,344,376,461,514,541,567,784 'refer':81,249,771 'referenc':661 'requir':78,774 'retent':149 'rubi':453,454 'run':62,739 'secret':61,72,80,166,173,217,232,243,248,267,274,657,792 'secret-cr':71 'server':132,135 'set':113,147,155,699 'skill' 'skill-telnyx-import-elevenlabs' 'skip':69 'source-team-telnyx' 'specif':478,803 'start':715 'step':74,222,279,474,583,641,652 'store':53,208,224,235 'string':777,785,801 'succeed':596 'suppli':674 'sync':764 'system.out.printf':445 'telnyx':2,9,17,37,46,59,183,187,215,231,245,270,302,327,329,331,335,361,363,367,501,590,603,707,724,752,790 'telnyx-import-elevenlab':1 'telnyx.aiassistantimportsparams':396 'telnyx.aiassistantimportsparamsproviderelevenlabs':398 'test':719,726,731 'tool':122,127,138,170,663 'topic-agent-skills' 'topic-ai-coding-agent' 'topic-claude-code' 'topic-cpaas' 'topic-cursor' 'topic-iot' 'topic-llm' 'topic-sdk' 'topic-sip' 'topic-sms' 'topic-speech-to-text' 'topic-telephony' 'transfer':124 'type':308,507,773 'upload':688 'url':136,692 'use':29,257,722,762 'user':44 'valu':119,180,677 'variabl':116 'verifi':66,585,734 'via':268,276 'voic':106,110 'webhook':125 'x':297,496 'yes':93,101,108,117,126,134,143,151,778,786","prices":[{"id":"28f9590c-0e9a-42c7-a9f6-30fa507fc944","listingId":"8651eefb-fb71-4ead-8595-9cb3e95f68c8","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"team-telnyx","category":"ai","install_from":"skills.sh"},"createdAt":"2026-04-18T22:06:29.424Z"}],"sources":[{"listingId":"8651eefb-fb71-4ead-8595-9cb3e95f68c8","source":"github","sourceId":"team-telnyx/ai/telnyx-import-elevenlabs","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-import-elevenlabs","isPrimary":false,"firstSeenAt":"2026-04-18T22:06:29.424Z","lastSeenAt":"2026-04-22T12:54:45.657Z"}],"details":{"listingId":"8651eefb-fb71-4ead-8595-9cb3e95f68c8","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-import-elevenlabs","github":{"repo":"team-telnyx/ai","stars":167,"topics":["agent-skills","ai","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk","sip","sms","speech-to-text","telephony","telnyx","tts","twilio-migration","voice-agents","voice-ai","webrtc","windsurf"],"license":"mit","html_url":"https://github.com/team-telnyx/ai","pushed_at":"2026-04-21T22:09:49Z","description":"Official one-stop shop for AI Agents and developers building with Telnyx.","skill_md_sha":"65add8238d8cfdf931849bbf41809c8cebb96548","skill_md_path":"skills/telnyx-import-elevenlabs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-import-elevenlabs"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-import-elevenlabs","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-import-elevenlabs"},"updatedAt":"2026-04-22T12:54:45.657Z"}}