---
title: "Create call link"
method: POST
path: "/call-link/1/links"
tags: ["channels", "webrtc-calls", "call-link", "call-links"]
---

# Create call link

`POST /call-link/1/links`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/call-link/1/links`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Create a link to send to someone who will then initiate a call.

## Request body

- Ae8a6eecccfb565f1840ac10e7bfb960a35d1e256ae31abf1bdea45a1d2f5557CallLinkRequest: Enable calls between users that have an Infobip account and users that don't.
  - `identity` string: Identity of a user that will use a call link. Must not be set if the destination type of a call link is ROOM.
  - `displayName` string: Display name of a user that will use a call link to initiate a call. Must not be set if the destination type of a call link is ROOM. For other destination types, if you want to set a display name, also set identity.
  - `showIdentity` boolean: Show identity or displayName on before a call.
  - `destination` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14Destination, required: Description of who or what is going to receive a call.
    - `type` 'WEBRTC' | 'CONVERSATIONS' | 'ROOM' | 'PHONE' | 'VIBER' | 'APPLICATION'
  - `customData` object: Custom attributes sent in a call once it has started.
  - `validityWindow` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14ValidityWindow: Description of a call link validation period and the number of times it can be used within the range.
    - `oneTime` boolean: By default, call links are generated for multiple calls.If you want to limit the period for how long a link is valid, specify the start and end time. If you want to invalidate a link after establishing a call, set this value to 'true' (defaults to 'false').For ROOM calls, this value cannot be 'true'.
    - `startTime` string, date-time: Specify starting moment in the UTC timezone for when a call link becomes valid. Defaults to the time when a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
    - `endTime` string, date-time: Specify ending moment in the UTC timezone for when a call link becomes invalid. Default value is 24 hours after a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
    - `acceptableHours` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14AcceptableHours: Specify time range within a day when a link can be used. It is 00:00 - 23:59, by default. UTC timezone is used.
      - `start` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
        - `hour` integer
        - `minute` integer
      - `end` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
        - `hour` integer
        - `minute` integer
    - `acceptableDays` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14DayOfWeek[]: Specify the days a link can be used. It is every day of the week, by default.
  - `callLinkConfigId` string: Identifier of a call link configuration. You can use your existing configuration. If this parameter is not sent and there are call link configurations available, the default one will be used. If there are no configurations, the one with system default values will be used.

## Response `201`

Created

- Ae8a6eecccfb565f1840ac10e7bfb960a35d1e256ae31abf1bdea45a1d2f5557CallLinkResponse
  - `id` string: Identifier of the created call link. To open a call link, an ID will be concatenated to the URL: https://call-link.com/.
  - `url` string: A URL to initiate the call.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)