ifttt

# 🔀 IFTTT

IFTTT (If This Then That) automation — trigger webhooks, manage applets, and fire events via the IFTTT Webhooks and API.

## Features

- **Webhook triggers** — fire custom events with data
- **Event data** — pass up to 3 values per trigger
- **Service queries** — check connection status
- **User info** — get authenticated user details
- **Applet management** — list and manage applets (Connect API)
- **Trigger history** — recent webhook activity
- **Multi-event** — fire multiple events in sequence
- **JSON payload** — send structured data via webhooks

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `IFTTT_WEBHOOK_KEY` | ✅ | API key/token for IFTTT |

## Quick Start

```bash
# Fire a webhook event
python3 {baseDir}/scripts/ifttt.py trigger my_event --value1 "Hello" --value2 "World"
```

```bash
# Fire with JSON payload
python3 {baseDir}/scripts/ifttt.py trigger-json my_event '{"value1":"data1","value2":"data2","value3":"data3"}'
```

```bash
# Check webhook connectivity
python3 {baseDir}/scripts/ifttt.py status
```

```bash
# Get user info (Connect API)
python3 {baseDir}/scripts/ifttt.py user
```



## Commands

### `trigger`
Fire a webhook event.
```bash
python3 {baseDir}/scripts/ifttt.py trigger my_event --value1 "Hello" --value2 "World"
```

### `trigger-json`
Fire with JSON payload.
```bash
python3 {baseDir}/scripts/ifttt.py trigger-json my_event '{"value1":"data1","value2":"data2","value3":"data3"}'
```

### `status`
Check webhook connectivity.
```bash
python3 {baseDir}/scripts/ifttt.py status
```

### `user`
Get user info (Connect API).
```bash
python3 {baseDir}/scripts/ifttt.py user
```

### `applets`
List applets (Connect API).
```bash
python3 {baseDir}/scripts/ifttt.py applets --limit 20
```

### `applet-enable`
Enable an applet.
```bash
python3 {baseDir}/scripts/ifttt.py applet-enable abc123
```

### `applet-disable`
Disable an applet.
```bash
python3 {baseDir}/scripts/ifttt.py applet-disable abc12...