Documentation Index

Fetch the complete documentation index at: https://docs.unpod.dev/llms.txt

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

{
  "status_code": 201,
  "message": "Provider configuration created successfully.",
  "data": {
    "id": 42,
    "provider": "twilio",
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "created_at": "2026-02-07T10:00:00Z"
  }
}

​

Create Provider Configuration

​

Headers

​

Request Body

​

Response Fields

​

Provider Config Object Fields

​

Common Error Codes

​

Code Examples

const axios = require('axios');

const headers = {
  'Authorization': 'Token your-api-token',
  'Org-Handle': 'your-org-handle',
  'Content-Type': 'application/json'
};

// Create a provider configuration
const createProvider = async (provider, accountSid, authToken) => {
  const response = await axios.post(
    'https://unpod.ai/api/v2/platform/telephony/providers-configurations/',
    { provider, account_sid: accountSid, auth_token: authToken },
    { headers }
  );
  console.log(`Provider created with ID: ${response.data.data.id}`);
  return response.data.data;
};

// Example usage
createProvider('twilio', 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'your-auth-token');

​

Best Practices

1. Provider Slug: Use the slug from the Get Telephony Providers endpoint to identify the provider
2. Credential Security: Never log or expose auth_token values — treat them as secrets
3. Credential Rotation: Use the Update Provider endpoint to rotate credentials without deleting the configuration
4. Configuration ID: Store the returned id to reference this configuration when connecting to bridges
5. Error Handling: Handle 400 errors that indicate invalid credentials before they cause production issues
6. Security: Keep API tokens secure and rotate them regularly