> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Links Overview

> Create and manage trigger links that fire workflow automation when clicked in the HoopAI Platform REST API.

The Trigger Links API lets you create, retrieve, update, delete, and search trigger links in your HoopAI Platform account. A trigger link is a special trackable URL that fires a workflow automation when a contact clicks it, making it a powerful tool for behavioral-based marketing and engagement tracking.

## Base URL

```
https://services.leadconnectorhq.com
```

## Authentication

Every request must include a bearer token in the `Authorization` header and the API version in the `Version` header.

```http theme={null}
Authorization: Bearer <access_token>
Version: 2021-07-28
```

Use an access token generated for a **Account** user type, or a Private Integration Token scoped to the account.

## OAuth scopes

| Scope            | Access                                   |
| ---------------- | ---------------------------------------- |
| `links.readonly` | Read trigger link configurations         |
| `links.write`    | Create, update, and delete trigger links |

## Quick start

Retrieve all trigger links for a location:

```bash theme={null}
curl -X GET "https://services.leadconnectorhq.com/links/?locationId=ve9EPM428h8vShlRW1KT" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28"
```

## Endpoints

| Method   | Path                 | Description          |
| -------- | -------------------- | -------------------- |
| `GET`    | `/links/`            | Get Links            |
| `POST`   | `/links/`            | Create Link          |
| `GET`    | `/links/id/{linkId}` | Get Link by ID       |
| `PUT`    | `/links/{linkId}`    | Update Link          |
| `DELETE` | `/links/{linkId}`    | Delete Link          |
| `GET`    | `/links/search`      | Search Trigger Links |

## Related

* [Workflows API overview](/api-reference/workflows/overview) — build automations that trigger link clicks activate
* [Contacts API overview](/api-reference/contacts/overview) — manage contacts whose clicks are tracked
* [OAuth 2.0 overview](/api-reference/oauth/overview) — obtain and refresh access tokens