---
title: How to Set Up Completion Events in Tiled
description: Track when a viewer reaches a key moment in your microapp and optionally trigger a notification or automation when it happens using completion events.
---

[Skip to content](https://support.tiled.co/how-to-set-up-completion-events-in-tiled#main-content)

English

Show submenu for translations

[Submit a request](https://support.tiled.co/kb-tickets/new)

![logo-horizontal\_w.png\]](https://support.tiled.co/hs-fs/hubfs/logo-horizontal_w.png?height=30&name=logo-horizontal_w.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Submit a request](https://support.tiled.co/kb-tickets/new)

 Hi, how can we help you?

- There are no suggestions because the search field is empty.

1. [Support](https://support.tiled.co/)
2. [Builder 2.0](https://support.tiled.co/builder-2-0)
3. [Layers & Settings 2.0](https://support.tiled.co/builder-2-0#layers-settings-2-0)

# How to Set Up Completion Events in Tiled

## Track when a viewer reaches a key moment in your microapp and optionally trigger a notification or automation when it happens

<iframe data-hsv-src="https://play.hubspotvideo.com/v/4720090/id/223771188082" referrerpolicy="origin" sandbox="allow-forms allow-scripts allow-same-origin allow-popups" allow="autoplay; fullscreen;" style="position: absolute !important; width: 100% !important; height: 100% !important; left: 0; top: 0; border: 0 none; pointer-events: initial" title="HubSpot Video" loading="lazy" data-hsv-id="223771188082" data-hsv-style="" data-hsv-width="1920" data-hsv-height="1080" data-hsv-autoplay="false" data-hsv-loop="false" data-hsv-muted="false" data-hsv-hidden-controls="false" data-hsv-full-width="false"></iframe>

### **Overview**

A completion event marks the moment a viewer does something you’ve defined as meaningful — reaching a pricing page, watching a video, clicking a call to action, or spending a set amount of time in a microapp. Completions show up in your engagement analytics, raise the recipient’s Tiled Score, and can notify another system through a webhook.

### **Before You Start**

• **Role** — you need Editor, Library Admin, or Account Admin access to edit the microapp.

• **Webhook endpoint (optional)** — only needed if you want completions to trigger something outside Tiled. It must accept incoming POST requests.

### **Choosing a Completion Type**

There are four ways to define a completion. You can use more than one in the same microapp.

[![Completion Events Callouts-1-choose-a-completion-type](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-1-choose-a-completion-type.png?width=670&height=431&name=Completion%20Events%20Callouts-1-choose-a-completion-type.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-1-choose-a-completion-type.png)

| **Type** | **Fires When** | **Good For** |
| --- | --- | --- |
| **Page** | The viewer reaches a specific page, subpage, overlay, or state. | Pricing pages, next-steps pages, the last screen of a training module. |
| **Video Tile** | The viewer plays a specific video. | Product demos and explainer videos you want to know were watched. |
| **Hotspot** | The viewer clicks a specific Hotspot tile. | Calls to action like Contact Us, Book a Demo, or Get Started. |
| **Duration** | The viewer has spent a set amount of time in the microapp. | Training and onboarding content, where time spent signals engagement. |

### **Page Completion**

1\. **Open the microapp** — in the Builder.

2\. **Go to the page** — subpage, overlay, or state you want to mark.

3\. **Find the Completion slider** — at the top right of the Builder.

4\. **Slide it all the way to the right** — until it turns green.

A green check mark appears under that page’s thumbnail in the Pages panel. To remove the completion, slide it back to the left until it turns white.

[![Completion Events Callouts-2-page-completion](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-2-page-completion.png?width=670&height=431&name=Completion%20Events%20Callouts-2-page-completion.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-2-page-completion.png)

| **Heads Up:** Slide it all the way. A slider left partway doesn’t save, and the check mark won’t appear. |
| --- |

### **Video Tile Completion**

1\. **Select the Video tile** — on your page.

2\. **Find the Completion slider** — in the tile’s properties.

3\. **Slide it to the right** — to turn it on.

When a viewer plays that video, Tiled records a completion for the microapp.

[![Completion Events Callouts-3-video-tile-completion](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-3-video-tile-completion.png?width=670&height=431&name=Completion%20Events%20Callouts-3-video-tile-completion.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-3-video-tile-completion.png)

### **Hotspot Completion**

1\. **Select the Hotspot tile.** — Choose the one that represents the action you want to track.

2\. **Slide the Completion slider to the right** — in the tile’s properties.

[![Completion Events Callouts-4-hotspot-completion](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-4-hotspot-completion.png?width=670&height=431&name=Completion%20Events%20Callouts-4-hotspot-completion.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-4-hotspot-completion.png)

| **Heads Up:** Completion is set per Hotspot tile, not per link. If one Hotspot tile contains several links, clicking any of them fires the completion. To track links separately, put each one in its own Hotspot tile. |
| --- |

### **Duration Completion**

1\. **Open Microapp Settings** — select the dropdown arrow next to the microapp name in the Builder, then choose General.

2\. **Find the Completion field.** — It sets how long a viewer must spend in the microapp.

3\. **Enter the duration** — and save.

The viewer must stay in the microapp for the full duration before the completion fires.

[![Completion Events Callouts-5-duration-completion](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-5-duration-completion.png?width=670&height=431&name=Completion%20Events%20Callouts-5-duration-completion.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-5-duration-completion.png)

### **Sending Completions to Another System**

By default, completions stay in Tiled, in your analytics and the Tiled Score. To trigger something elsewhere — a Slack message, a CRM update, a custom analytics event — add a webhook.

### **How it works**

Each microapp has one webhook URL. Every time that microapp records a completion, of any type, Tiled sends an HTTP POST request to that URL, and your endpoint decides what to do with it.

### **Setting it up**

1\. **Create an endpoint** — on your side that accepts incoming POST requests.

2\. **Add the URL** — as the webhook URL in the microapp’s settings.

3\. **Handle the request** — build the logic on your endpoint that acts on each completion.

[![Completion Events Callouts-6-send-completion-elsewhere](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-6-send-completion-elsewhere.png?width=670&height=431&name=Completion%20Events%20Callouts-6-send-completion-elsewhere.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-6-send-completion-elsewhere.png)

| **Pro Tip:** For testing, a request-inspection service gives you a temporary endpoint in seconds and shows each incoming request as it arrives. Switch to your real endpoint before going live. |
| --- |

### **Payload**

Each request sends this JSON body:

```
{"userId": "recipient@example.com","microappId": "5ca668834b320d1f53dc7bab","microappName": "Product Overview","completionName": "cmptscreen5cca158fa969a00eee04ba12"}
```

| **Field** | **Description** |
| --- | --- |
| **userId** | Email address of the viewer who triggered the completion. |
| **microappId** | Unique ID of the microapp. |
| **microappName** | Display name of the microapp. |
| **completionName** | System identifier for the completion that fired. The same value appears in the Completion Name column of CSV exports. |

[![Completion Events Callouts-7-payload](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-7-payload.png?width=670&height=431&name=Completion%20Events%20Callouts-7-payload.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-7-payload.png)

| **Heads Up:** Webhook requests are sent without authentication headers, so your endpoint has to accept unauthenticated POST requests. Use an endpoint URL that’s hard to guess, and check that each request’s microappId matches a microapp you expect before acting on it. |
| --- |

### **Checking That It Works**

1\. **Publish the microapp.** — Completions only fire on the published version.

2\. **Send yourself a Direct Share link** — using an email address that isn’t your Tiled login, and trigger the completion.

3\. **Check your analytics.** — The completion appears in the microapp’s engagement data, and in the Completions count in Pathway Analytics for that link.

4\. **Check your endpoint** — if you set up a webhook, confirm the request arrived.

[![Completion Events Callouts-8-check-that-it-works](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-8-check-that-it-works.png?width=670&height=431&name=Completion%20Events%20Callouts-8-check-that-it-works.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-8-check-that-it-works.png)

| **Try It Yourself:** Set a page completion on your final screen and a Hotspot completion on your call-to-action button, then send yourself a Direct Share link. Compare which completions fire when you only read to the end versus when you click the button. |
| --- |

### **Where Completions Show Up**

| **Place** | **What You See** |
| --- | --- |
| **Engagement analytics** | Completion counts for the microapp, including in My Activity. |
| **Pathway Analytics** | The Completions card, showing whether one recipient reached them. |
| **Tiled Score** | Completions are one of the factors that raise a recipient’s score. |
| **CSV exports** | Completion Events and Completion Name columns for each session. |
| **Your webhook** | A POST request for every completion, if configured. |

### **[![Completion Events Callouts-9-where-completions-show-up](https://support.tiled.co/hs-fs/hubfs/Completion%20Events%20Callouts-9-where-completions-show-up.png?width=670&height=431&name=Completion%20Events%20Callouts-9-where-completions-show-up.png)](https://support.tiled.co/hubfs/Completion%20Events%20Callouts-9-where-completions-show-up.png)Common Questions**

| **Question** | **Answer** |
| --- | --- |
| **The check mark isn’t showing after I set a page completion.** | Slide the Completion slider all the way to the right until it turns green. A partial position doesn’t save. |
| **Clicking any link in my Hotspot fires the completion.** | Completion is set per Hotspot tile. Put each link you want to track in its own Hotspot tile. |
| **My webhook isn’t receiving anything.** | Check that the URL is entered correctly in the microapp’s settings, that the microapp is published, and that your endpoint accepts unauthenticated POST requests. |
| **My duration completion never fires.** | Check the duration in Microapp Settings → General. The viewer has to stay in the microapp for the full time. |
| **Can one microapp have several completions?** | Yes. You can combine page, video, hotspot, and duration completions in the same microapp. Each one is counted and sent to the webhook separately. |
| **Can I have more than one webhook per microapp?** | No. Each microapp has one webhook URL. To notify several systems, have your endpoint forward the request. |

### **Related Articles**

• [**How to Read the Tiled Score**](https://support.tiled.co/how-to-read-the-tiled-score) — How completions affect a recipient’s score.

• [**Engagement: Pathway Analytics**](https://support.tiled.co/engagement-pathway-analytics) — Whether one recipient reached your completions.

• [**Export Engagement Analytics CSV**](https://support.tiled.co/export-engagement-analytics-csv) — The Completion Events and Completion Name columns.

• [**Microapp Settings**](https://support.tiled.co/microapp-settings-general) — The General tab, where duration completion is set.

• [**Hotspot Tile**](https://support.tiled.co/hotspot-tile-2.0) — Setting up the clicks you can track as completions.

• [**Webhooks**](https://support.tiled.co/webhooks) — Using webhooks with Tiled.

- [Getting Started](https://support.tiled.co/getting-started#main-content)

    - [Intro to Tiled](https://support.tiled.co/getting-started#intro-to-tiled)
    - [Tiled Library](https://support.tiled.co/getting-started#tiled-library)
- [Tiled Builder](https://support.tiled.co/tiled-builder#main-content)

    - [Tiled Builder](https://support.tiled.co/tiled-builder#tiled-builder)
    - [Microapp Tiles](https://support.tiled.co/tiled-builder#microapp-tiles)
    - [Personalization](https://support.tiled.co/tiled-builder#personalization)
    - [Asset Library](https://support.tiled.co/tiled-builder#asset-library)
    - [Best Practices](https://support.tiled.co/tiled-builder#best-practices)
- [Tiled Tiles](https://support.tiled.co/tiled-tiles)
- [Settings](https://support.tiled.co/settings#main-content)

    - [Account Settings](https://support.tiled.co/settings#account-settings)
    - [Library Settings](https://support.tiled.co/settings#library-settings)
    - [Microapp Settings](https://support.tiled.co/settings#microapp-settings)
- [Sharing & Analytics](https://support.tiled.co/sharing-analytics#main-content)

    - [Microapp Analytics](https://support.tiled.co/sharing-analytics#microapp-analytics)
    - [Personalization](https://support.tiled.co/sharing-analytics#personalization)
    - [Sharing Microapps](https://support.tiled.co/sharing-analytics#sharing-microapps)
- [Useful Resources](https://support.tiled.co/useful-resources#main-content)

    - [Additional Guides](https://support.tiled.co/useful-resources#additional-guides)
    - [Developer Tools](https://support.tiled.co/useful-resources#developer-tools)
    - [Accessibility](https://support.tiled.co/useful-resources#accessibility)
    - [Tiled Mobile App](https://support.tiled.co/useful-resources#tiled-mobile-app)
    - [Seismic](https://support.tiled.co/useful-resources#seismic)
    - [Authentication & Security](https://support.tiled.co/useful-resources#authentication-security)
- [Builder 2.0](https://support.tiled.co/builder-2-0#main-content)

    - [Tiled Builder 2.0](https://support.tiled.co/builder-2-0#tiled-builder-2-0)
    - [Microapp Tiles 2.0](https://support.tiled.co/builder-2-0#microapp-tiles-2-0)
    - [Personalization 2.0](https://support.tiled.co/builder-2-0#personalization-2-0)
    - [Asset Panel 2.0](https://support.tiled.co/builder-2-0#asset-panel-2-0)
    - [Layers & Settings 2.0](https://support.tiled.co/builder-2-0#layers-settings-2-0)
    - [FAQ](https://support.tiled.co/builder-2-0#faq)
- [Tiled Plugins](https://support.tiled.co/tiled-plugins#main-content)

    - [Figma Plugin](https://support.tiled.co/tiled-plugins#figma-plugin)
    - [Adobe XD Plugin](https://support.tiled.co/tiled-plugins#adobe-xd-plugin)
    - [Sketch Plugin](https://support.tiled.co/tiled-plugins#sketch-plugin)
- [Integrations](https://support.tiled.co/integrations#main-content)

    - [CRM & Marketing Automation](https://support.tiled.co/integrations#crm-marketing-automation)
    - [Content & Asset Management](https://support.tiled.co/integrations#content-asset-management)
    - [Collaboration & Communication](https://support.tiled.co/integrations#collaboration-communication)
- [New Releases](https://support.tiled.co/new-releases#main-content)

    - [v65.0.0](https://support.tiled.co/new-releases#v65-0-0)
    - [v64.0.0](https://support.tiled.co/new-releases#v64-0-0)
    - [v63.0.0](https://support.tiled.co/new-releases#v63-0-0)
    - [v62.0.0](https://support.tiled.co/new-releases#v62-0-0)
    - [v61.0.1](https://support.tiled.co/new-releases#v61-0-1)
    - [v60.0.0](https://support.tiled.co/new-releases#v60-0-0)
    - [v59.0.0](https://support.tiled.co/new-releases#v59-0-0)
    - [v58.0.0](https://support.tiled.co/new-releases#v58-0-0)
    - [v57.0.0](https://support.tiled.co/new-releases#v57-0-0)
    - [v56.0.0](https://support.tiled.co/new-releases#v56-0-0)
    - [v55.0.1](https://support.tiled.co/new-releases#v55-0-1)
    - [v54.0.0](https://support.tiled.co/new-releases#v54-0-0)
    - [v53.0.0](https://support.tiled.co/new-releases#v53-0-0)
    - [v52.0.0](https://support.tiled.co/new-releases#v52-0-0)
    - [v51.0.0](https://support.tiled.co/new-releases#v51-0-0)
    - [v50.0.0](https://support.tiled.co/new-releases#v50-0-0)

[![logo-horizontal\_k-3](https://support.tiled.co/hs-fs/hubfs/logo-horizontal_k-3.png?width=100&height=21&name=logo-horizontal_k-3.png "logo-horizontal_k-3")](https://tiled.co)

Copyright © 2026, Tiled

```json
{
  "@context" : "https://schema.org",
  "@type" : "VideoObject",
  "contentUrl" : "https://4720090.fs1.hubspotusercontent-na1.net/hubfs/4720090/Completion%20Events%20Animation.mp4",
  "dateModified" : "2026-10-06T20:13:08.697Z",
  "duration" : "PT41.4S",
  "height" : 1080,
  "name" : "Completion Events Animation",
  "thumbnailUrl" : "https://4720090.fs1.hubspotusercontent-na1.net/hubfs/4720090/Completion%20Events%20Animation.mp4/medium.jpg",
  "uploadDate" : "2026-10-06T20:13:08.694Z",
  "width" : 1920
}
```