> ## Documentation Index > Fetch the complete documentation index at: https://docs.itellico.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create SIP trunk > Create a Bring-Your-Own-Carrier (BYOC) SIP trunk for inbound/outbound calls. For trunks that target FusionPBX, provisioning is performed synchronously. ## OpenAPI ````yaml https://api.itellico.ai/v1/openapi.json post /v1/accounts/{account_id}/sip-trunks openapi: 3.1.0 info: title: itellicoAI API v1 version: 1.0.0 description: >- Public REST API for managing accounts, agents, telephony resources, and conversations. Authentication is via API key in the `X-API-Key` header. termsOfService: https://itellico.ai/legal/terms-and-conditions/ contact: name: itellicoAI Support email: support@itellico.ai license: name: Proprietary servers: - url: https://api.itellico.ai description: Production security: - APIKeyAuth: [] tags: - name: Accounts description: >- Identify the current account context and fetch core account metadata to bootstrap API usage. - name: Subaccounts description: >- Create and manage child accounts under a parent to model tenant hierarchies and delegated access. - name: Agents description: >- Define and configure conversational agents (model, transcriber, voice, behavior) used in calls and automations. - name: Providers description: >- Discover available AI model, transcriber, and voice catalogs for the current account when configuring agents. - name: Phone Numbers description: >- Manage BYOC phone numbers bound to your account; route inbound calls to agents and enable outbound calling. - name: SIP Trunks description: >- Manage BYOC SIP trunk connectivity (origination/termination endpoints and allowed IPs) used by phone numbers. - name: Calls description: >- Create, list, inspect, and connect voice calls across phone and web channels. - name: Conversations description: List and inspect conversation activity across web and telephony channels. - name: Analytics description: Usage analytics and reporting endpoints for conversation activity. paths: /v1/accounts/{account_id}/sip-trunks: post: tags: - SIP Trunks summary: Create SIP trunk description: >- Create a Bring-Your-Own-Carrier (BYOC) SIP trunk for inbound/outbound calls. For trunks that target FusionPBX, provisioning is performed synchronously. operationId: createSipTrunk parameters: - in: path name: account_id schema: format: uuid4 title: Account Id type: string required: true requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateByocSipTrunkDTO' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/SIPTrunkV1Out' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '502': description: Bad Gateway content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' security: - APIKeyAuth: [] components: schemas: CreateByocSipTrunkDTO: properties: name: anyOf: - type: string - type: 'null' title: Name termination_uri: anyOf: - type: string - type: 'null' title: Termination Uri allowed_ips: anyOf: - items: type: string type: array - type: 'null' description: IPv4/IPv6 or CIDR ranges title: Allowed Ips title: CreateByocSipTrunkDTO type: object SIPTrunkV1Out: properties: id: format: uuid4 title: Id type: string phone_numbers: items: $ref: '#/components/schemas/PhoneNumberBasicV1Out' title: Phone Numbers type: array has_auth_password: default: false title: Has Auth Password type: boolean auth_password_length: anyOf: - type: integer - type: 'null' title: Auth Password Length allowed_ips: items: type: string title: Allowed Ips type: array name: description: Display name for this SIP trunk maxLength: 100 title: Name type: string termination_uri: anyOf: - type: string - type: 'null' title: Termination URI sip_auth_username: anyOf: - maxLength: 100 type: string - type: 'null' title: SIP Auth Username required: - id - name title: SIPTrunkV1Out type: object ErrorSchema: description: |- Standard error response payload for all API endpoints. Follows industry best practices (similar to Stripe, RetellAI): - code: Machine-readable error identifier for programmatic handling - message: Human-readable description for display - detail: Optional additional context for debugging - errors: Optional list of field-level validation errors examples: - code: not_found detail: Agent with UUID 123e4567-e89b-12d3-a456-426614174000 does not exist message: Resource not found - code: validation_error errors: - field: body.email message: Invalid email format type: value_error - field: body.name message: Field required type: missing message: Validation failed properties: code: description: Machine-readable error code (e.g., 'not_found', 'validation_error') title: Code type: string message: description: Human-readable error message title: Message type: string detail: anyOf: - type: string - type: 'null' description: Optional detailed context for debugging title: Detail errors: anyOf: - items: $ref: '#/components/schemas/FieldErrorSchema' type: array - type: 'null' description: Field-level validation errors (for 422 responses) title: Errors required: - code - message title: ErrorSchema type: object PhoneNumberBasicV1Out: properties: id: format: uuid4 title: Id type: string number: anyOf: - type: string - type: 'null' title: Number friendly_name: anyOf: - maxLength: 100 type: string - type: 'null' title: Friendly Name required: - id title: PhoneNumberBasicV1Out type: object FieldErrorSchema: description: Schema for individual field validation errors. properties: field: description: Field path (e.g., 'body.name', 'query.page') title: Field type: string message: description: Human-readable error message title: Message type: string type: description: Error type (e.g., 'value_error', 'type_error') title: Type type: string required: - field - message - type title: FieldErrorSchema type: object securitySchemes: APIKeyAuth: type: apiKey in: header name: X-API-Key ````