Create adaptive links using the dashboard

Use the Airship dashboard to create and configure settings for adaptive links.

 Note

You must use the API to create adaptive links for event tickets and boarding passes. See:

You must have at least one Apple Wallet and one Google Wallet template to create an adaptive link.

  1. Go to Templates.

  2. Click anywhere in a template’s row to see its expanded view, then click Create an Adaptive Link.

  3. Enter a descriptive name for the link, then enter a template name or ID and select from the results.

    • You only need to enter a name OR specify a template. Both can be edited after saving.
    • The name appears in the list of all the template’s adaptive links. It does not appear to recipients of the link. If you do not enter a name, it will automatically generate after saving based on the template you select in the next step.
    • To change your template selection, click and start over.
  4. Choose what will happen if the pass is opened in a desktop browser or undetectable device type rather than a mobile device.

    • Display error on the device — The device will display: {"error":{"code":1004,"message":"Device not supported."}}.

    • Redirect to a landing page — Enter the URL that the pass link should redirect to.

       Important

      If you intend to send the link to web browsers via the Adaptive Link action in the dashboard, select Redirect to a landing page to ensure that your web users do not get an error. See:

  5. Configure options:

    • Personalized — Determines whether the link generates a new pass each time the adaptive link is clicked.

      • When enabled (box checked), an individual pass URL is generated each time the adaptive link is clicked, e.g., 10 clicks = 10 unique passes created.

        If you designed the pass templates to use personalized data such as first name, points, or a barcode value, enable this feature.

      • When disabled (box unchecked), the same pass is returned each time the adaptive link is clicked, e.g., 10 clicks = 1 unique pass created.

         Note

        • In almost all cases, you will want to leave Personalized disabled to ensure only one pass ID exists for each personalized pass.

        • When Personalized is disabled, you cannot update an adaptive link to update passes generated from the adaptive link. Rather, you must publish template updates through the dashboard or using the Bulk Update API to push updates to passes generated from the adaptive link.

    • Limit available passes — Enter the number of passes that can be created from the adaptive link. When disabled, the number of passes is not limited. A value is required when editing an existing adaptive link.

    • Expiration date — Controls when the link will no longer generate passes. Select a date up to 1,080 days in the future. If left blank, the link remains valid as long as it is actively in use.

  6. Click Save.