# uip is triggers

> `uip is triggers` is the read-only view onto a connector's event hooks — the metadata that backs trigger activities. A trigger fires when a connector object is `CREATED`, `UPDATED`, or `DELETED`. `objects` lists the objects that support a trigger operation; `describe` returns the full trigger metadata (event mode, parameters, filter fields, output fields) for one object. Both verbs cache results; `--connection-id` is optional but recommended — without it, custom objects/fields may be missing and the response carries a `Warning`.

`uip is triggers` is the read-only view onto a connector's event hooks — the metadata that backs trigger activities. A trigger fires when a connector object is `CREATED`, `UPDATED`, or `DELETED`. `objects` lists the objects that support a trigger operation; `describe` returns the full trigger metadata (event mode, parameters, filter fields, output fields) for one object. Both verbs cache results; `--connection-id` is optional but recommended — without it, custom objects/fields may be missing and the response carries a `Warning`.

## Synopsis

```
uip is triggers <verb> [options]
```

## Verbs

| Verb | Purpose |
|---|---|
| `objects` | List objects that support a trigger operation on a connector. |
| `describe` | Get full trigger metadata for one object under one operation. |

## uip is triggers objects

List objects that support a given trigger operation on a connector. Cached results are only written when `--connection-id` is provided.

### Arguments

| Name | Required | Purpose |
|---|---|---|
| `<connector-key>` | yes | Connector key, for example `uipath-zoho-desk`. |
| `<operation>` | yes | Trigger operation: `CREATED`, `UPDATED`, or `DELETED` (case-insensitive; normalized to uppercase). |

### Options

| Short | Long | Value | Default | Description |
|---|---|---|---|---|
| — | `--connection-id` | id | — | Scope to a connection (enables custom objects). |
| `-t` | `--tenant` | name | session default | Override the tenant. |
| — | `--refresh` | flag | off | Force re-fetch from the API, ignoring cache. |

### Examples

```bash
uip is triggers objects uipath-zoho-desk CREATED

# Connection-scoped — includes custom objects
uip is triggers objects uipath-zoho-desk UPDATED \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

uip is triggers objects uipath-zoho-desk DELETED \
    --output-filter 'Data[].{name:name, display:displayName}'
```

### Data shape (--output json)

```json
{
  "Code": "TriggerObjectList",
  "Data": [
    {
      "displayName": "Tickets",
      "name": "tickets",
      "isHidden": false,
      "supportedAuths": []
    }
  ]
}
```

Without `--connection-id`, the response carries a `Warning` noting that custom objects may be missing.

## uip is triggers describe

Return full trigger metadata for one object under one trigger operation: event mode (polling vs webhook), event parameters, filter fields, and output fields.

### Arguments

| Name | Required | Purpose |
|---|---|---|
| `<connector-key>` | yes | Connector key. |
| `<operation>` | yes | Trigger operation (`CREATED`, `UPDATED`, `DELETED`). |
| `<object-name>` | yes | Object name (for example, `tickets`). Find it with `triggers objects`. |

### Options

| Short | Long | Value | Default | Description |
|---|---|---|---|---|
| — | `--connection-id` | id | — | Scope to a connection (enables custom fields). |
| `-t` | `--tenant` | name | session default | Override the tenant. |
| — | `--refresh` | flag | off | Force re-fetch from the API, ignoring cache. |

### Examples

```bash
uip is triggers describe uipath-zoho-desk CREATED tickets

uip is triggers describe uipath-zoho-desk CREATED tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

uip is triggers describe uipath-zoho-desk UPDATED tickets \
    --output-filter 'Data.outputFields[].name'
```

### Data shape (--output json)

```json
{
  "Code": "TriggerMetadata",
  "Data": {
    "name": "tickets",
    "displayName": "Tickets",
    "elementKey": "uipath-zoho-desk",
    "operation": "CREATED",
    "eventMode": "polling",
    "eventParameters": [],
    "filterFields": [ { "name": "subject", "type": "string" } ],
    "outputFields": [ { "name": "id", "type": "string" } ]
  }
}
```

For CRUD-style operations, the response also surfaces a `Hint` suggesting the neighboring `triggers objects` command. Without `--connection-id`, the response carries a `Warning` about missing custom fields.

## Related

- [`uip is activities`](./uip-is-activities.md) — pass `--triggers` to list trigger activities only.
- [`uip is connectors`](./uip-is-connectors.md) — `connectors get` reports `HasEvents: "Yes"` for connectors that expose triggers.
- [`uip is connections`](./uip-is-connections.md) — supply `--connection-id` from a connection here for custom-aware metadata.
- [`uip is resources`](./uip-is-resources.md) — sibling resource for the data-plane (CRUD) side of the same connector.

## See also

- [Integration Service tool overview](./uip-is.md)
- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)