---
title: "POST /v1/managedShortLinks:create"
method: POST
path: "/v1/managedShortLinks:create"
tags: ["managedShortLinks"]
---

# POST /v1/managedShortLinks:create

`POST /v1/managedShortLinks:create`

Creates a managed short Dynamic Link given either a valid long Dynamic Link or details such as Dynamic Link domain, Android and iOS app information. The created short Dynamic Link will not expire. This differs from CreateShortDynamicLink in the following ways: - The request will also contain a name for the link (non unique name for the front end). - The response must be authenticated with an auth token (generated with the admin service account). - The link will appear in the FDL list of links in the console front end. The Dynamic Link domain in the request must be owned by requester's Firebase project.

## Request body

- CreateManagedShortLinkRequest — Request to create a managed Short Dynamic Link.
  - `suffix` Suffix — Short Dynamic Link suffix.
    - `option` 'OPTION_UNSPECIFIED' | 'UNGUESSABLE' | 'SHORT' | 'CUSTOM' — Suffix option.
    - `customSuffix` string — Only applies to Option.CUSTOM.
  - `dynamicLinkInfo` DynamicLinkInfo — Information about a Dynamic Link.
    - `domainUriPrefix` string — E.g. https://maps.app.goo.gl, https://maps.page.link, https://g.co/maps More examples can be found in description of getNormalizedUriPrefix in j/c/g/firebase/dynamiclinks/uri/DdlDomain.java Will fallback to dynamic_link_domain is this field is missing
    - `dynamicLinkDomain` string — Dynamic Links domain that the project owns, e.g. abcd.app.goo.gl [Learn more](https://firebase.google.com/docs/dynamic-links/android/receive) on how to set up Dynamic Link domain associated with your Firebase project. Required if missing domain_uri_prefix.
    - `navigationInfo` NavigationInfo — Information of navigation behavior.
      - `enableForcedRedirect` boolean — If this option is on, FDL click will be forced to redirect rather than show an interstitial page.
    - `desktopInfo` DesktopInfo — Desktop related attributes to the Dynamic Link.
      - `desktopFallbackLink` string — Link to open on desktop.
    - `link` string — The link your app will open, You can specify any URL your app can handle. This link must be a well-formatted URL, be properly URL-encoded, and use the HTTP or HTTPS scheme. See 'link' parameters in the [documentation](https://firebase.google.com/docs/dynamic-links/create-manually). Required.
    - `iosInfo` IosInfo — iOS related attributes to the Dynamic Link..
      - `iosFallbackLink` string — Link to open on iOS if the app is not installed.
      - `iosCustomScheme` string — Custom (destination) scheme to use for iOS. By default, we’ll use the bundle ID as the custom scheme. Developer can override this behavior using this param.
      - `iosIpadFallbackLink` string — If specified, this overrides the ios_fallback_link value on iPads.
      - `iosBundleId` string — iOS bundle ID of the app.
      - `iosIpadBundleId` string — iPad bundle ID of the app.
      - `iosMinimumVersion` string — iOS minimum version.
      - `iosAppStoreId` string — iOS App Store ID.
    - `analyticsInfo` AnalyticsInfo — Tracking parameters supported by Dynamic Link.
      - `itunesConnectAnalytics` ITunesConnectAnalytics — Parameters for iTunes Connect App Analytics.
        - `ct` string — Campaign text that developers can optionally add to any link in order to track sales from a specific marketing campaign.
        - `at` string — Affiliate token used to create affiliate-coded links.
        - `mt` string — iTune media types, including music, podcasts, audiobooks and so on.
        - `pt` string — Provider token that enables analytics for Dynamic Links from within iTunes Connect.
      - `googlePlayAnalytics` GooglePlayAnalytics — Parameters for Google Play Campaign Measurements. [Learn more](https://developers.google.com/analytics/devguides/collection/android/v4/campaigns#campaign-params)
        - `utmSource` string — Campaign source; used to identify a search engine, newsletter, or other source.
        - `utmCampaign` string — Campaign name; used for keyword analysis to identify a specific product promotion or strategic campaign.
        - `gclid` string — Deprecated; FDL SDK does not process nor log it.
        - `utmMedium` string — Campaign medium; used to identify a medium such as email or cost-per-click.
        - `utmTerm` string — Campaign term; used with paid search to supply the keywords for ads.
        - `utmContent` string — Campaign content; used for A/B testing and content-targeted ads to differentiate ads or links that point to the same URL.
    - `socialMetaTagInfo` SocialMetaTagInfo — Parameters for social meta tag params. Used to set meta tag data for link previews on social sites.
      - `socialTitle` string — Title to be displayed. Optional.
      - `socialDescription` string — A short description of the link. Optional.
      - `socialImageLink` string — An image url string. Optional.
    - `androidInfo` AndroidInfo — Android related attributes to the Dynamic Link.
      - `androidFallbackLink` string — Link to open on Android if the app is not installed.
      - `androidMinPackageVersionCode` string — Minimum version code for the Android app. If the installed app’s version code is lower, then the user is taken to the Play Store.
      - `androidLink` string — If specified, this overrides the ‘link’ parameter on Android.
      - `androidPackageName` string — Android package name of the app.
  - `name` string — Link name to associate with the link. It's used for marketer to identify manually-created links in the Firebase console (https://console.firebase.google.com/). Links must be named to be tracked.
  - `longDynamicLink` string — Full long Dynamic Link URL with desired query parameters specified. For example, "https://sample.app.goo.gl/?link=http://www.google.com&apn=com.sample", [Learn more](https://firebase.google.com/docs/reference/dynamic-links/link-shortener).
  - `sdkVersion` string — Google SDK version. Version takes the form "$major.$minor.$patch"

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/firebasedynamiclinks.md) · [All operations](https://skmtc.dev/google/apis/firebasedynamiclinks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/firebasedynamiclinks/revisions/8ec7ec690ac4/schema)