Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oneinbox.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What is an integration?

An integration is a third-party API key stored securely inside OneInbox.
  • OneInbox encrypts the key at rest
  • The raw key is never returned after creation
  • You reference integrations by id in other API calls

​
When do you need one?

Integrations are optional for the first-agent quickstart — OneInbox provides default LLM, STT, and TTS. Add integrations when you want your own vendor billing or custom voices.
Use caseYou need it when…
Custom LLM billingYou want your own LLM account (BYOK)
TelephonyPhone calls (outbound or inbound)
Custom voicesImport a custom or cloned voice

​
How to create one

curl -X POST https://api.oneinbox.ai/v1/credentials \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "OpenAI Production",
    "provider": "openai",
    "api_key": "<your_provider_api_key>"
  }'

​
How integrations connect

Integration (optional BYOK)
        │
        ▼
LLM model with matching "provider"
        │
        ▼
Agent (llm_id) → Calls
Telephony integrations power Phone calls via credential_id on number search/register.

​
Manage integrations

curl https://api.oneinbox.ai/v1/credentials \
  -H "Authorization: Bearer <api_key>"

​
Next steps