> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a short link > Creates a short link that redirects to the target URL and tracks click metrics. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v1/short-links openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/short-links: post: tags: - Link shortener summary: Create a short link description: >- Creates a short link that redirects to the target URL and tracks click metrics. operationId: link_shortener_create parameters: [] requestBody: description: Attributes for the new short link. content: application/json: schema: allOf: - $ref: '#/components/schemas/ShortLinkCreateRequest' required: true responses: '200': description: Returns the created short link. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/ShortLinkResponse' examples: success: summary: Successful response value: short_link: https://wx.com/hd82Jhs21 '400': $ref: '#/components/responses/BadRequestErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' '404': $ref: '#/components/responses/NotFoundErrorResponse' '422': description: Returns a validation error when a field value is invalid. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/RecordNotFoundErrorResponse' examples: default: value: success: false message: Expiration time can't be in the past deprecated: false security: - bearerAuth: - campaigns:write components: schemas: ShortLinkCreateRequest: title: ShortLinkCreateRequest required: - link type: object additionalProperties: false properties: link: type: string description: Target URL to shorten. example: https://your-site.com/long-url expiration_time: type: string format: date-time description: Expiration date and time in ISO 8601 format. example: '2023-07-19T18:18:34.235Z' fallback_url: type: string description: Fallback URL for expired or invalid links. example: https://examples.com/fallback phone: type: string description: Phone number for the short link. example: '15155982927' utm_campaign: type: string description: UTM campaign name for tracking insights. example: summer_promo ShortLinkResponse: title: ShortLinkResponse required: - short_link type: object additionalProperties: false properties: short_link: type: string description: Generated short URL. example: https://wx.com/hd82Jhs21 RecordNotFoundErrorResponse: title: RecordNotFoundErrorResponse required: - success - message type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable error description example: Record not found example: success: false message: Record not found ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. NotFoundErrorResponse: title: NotFoundErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description stating that no resource matches the given ID. example: Record not found responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' NotFoundErrorResponse: description: Request failed. An object with the specified ID is not found. headers: {} content: application/json: schema: $ref: '#/components/schemas/NotFoundErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````