tookan

What this skill does

# Tookan

Tookan is a delivery management and field service automation platform. It helps businesses manage and optimize their dispatch operations, track agents in real-time, and automate tasks. It's used by businesses with delivery fleets or field service teams, such as restaurants, retailers, and logistics companies.

Official docs: https://tookan.freshdesk.com/support/home

## Tookan Overview

- **Task**
  - **Task Template**
- **Team**
- **Agent**
- **Customer**
- **Geofence**
- **User**
- **Add On**
- **Tag**
- **Template**
- **Form**
- **Report**
- **Pricing Add On**
- **Task Attributes**
- **Region**
- **Offer**
- **Wallet Transaction**
- **Reward**
- **Inventory**
- **Product**
- **Store**
- **Order**
- **Driver App**
- **Marketplace Subscription**
- **Subscription Package**
- **Payment Log**
- **Email Template**
- **SMS Template**
- **Custom Field**
- **File**
- **Notification**
- **Role**
- **Workforce**
- **Expense**
- **Leave**
- **Device**
- **Chat**
- **Label**
- **Announcement**
- **Auto Allocation**
- **Task Auto Allocation**
- **Template Auto Allocation**
- **Segment**
- **Booking**
- **Task Category**
- **Quick Task**
- **Dynamic Block**
- **Task Pickup Delivery Settings**
- **Task Reassignment**
- **Task Reassignment Reason**
- **Task Priority**
- **Task Type**
- **Task Checklist**
- **Task Custom Field**
- **Task Marketplace**
- **Task Default**
- **Task Time Slot**
- **Task Working Hours**
- **Task Sla**
- **Task Recurring**
- **Task Location**
- **Task Question**
- **Task Question Field**
- **Task Question Option**
- **Task Question Rule**
- **Task Question Dependency**
- **Task Question Visibility**
- **Task Question Validation**
- **Task Question Section**
- **Task Question Page**
- **Task Question Group**
- **Task Question Conditional**
- **Task Question Trigger**
- **Task Question Action**
- **Task Question Event**
- **Task Question Schedule**
- **Task Question Reminder**
- **Task Question Escalation**
- **Task Question Approval**
- **Task Question Rejection**
- **Task Question Comment**
- **Task Question Attachment**
- **Task Question Signature**
- **Task Question Location**
- **Task Question Geofence**
- **Task Question Barcode**
- **Task Question Qrcode**
- **Task Question Image**
- **Task Question Video**
- **Task Question Audio**
- **Task Question Date**
- **Task Question Time**
- **Task Question Datetime**
- **Task Question Number**
- **Task Question Text**
- **Task Question Textarea**
- **Task Question Select**
- **Task Question Multiselect**
- **Task Question Radio**
- **Task Question Checkbox**
- **Task Question File**
- **Task Question Table**
- **Task Question Map**
- **Task Question Rating**
- **Task Question Slider**
- **Task Question Signature Pad**
- **Task Question Drawing**
- **Task Question Html**
- **Task Question Css**
- **Task Question Javascript**
- **Task Question Json**
- **Task Question Xml**
- **Task Question Yaml**
- **Task Question Markdown**
- **Task Question Code**
- **Task Question Formula**
- **Task Question Calculation**
- **Task Question Summary**
- **Task Question Report**
- **Task Question Dashboard**
- **Task Question Integration**
- **Task Question Automation**
- **Task Question Workflow**
- **Task Question Api**
- **Task Question Webhook**
- **Task Question Email**
- **Task Question Sms**
- **Task Question Push**
- **Task Question Notification**
- **Task Question Log**
- **Task Question Error**
- **Task Question Debug**
- **Task Question Test**
- **Task Question Mock**
- **Task Question Example**
- **Task Question Tutorial**
- **Task Question Help**
- **Task Question Documentation**
- **Task Question Support**
- **Task Question Feedback**
- **Task Question Review**
- **Task Question Rating**
- **Task Question Comment**
- **Task Question Share**
- **Task Question Print**
- **Task Question Export**
- **Task Question Import**
- **Task Question Backup**
- **Task Question Restore**
- **Task Question Version**
- **Task Question History**
- **Task Question Audit**
- **Task Question Security**
- **Task Question Privacy**
- **Task Question Compliance**
- **Task Question Legal**
- **Task Question Terms**
- **Task Question Policy**
- **Task Question Disclaimer**
- **Task Question Copyright**
- **Task Question Trademark**
- **Task Question Patent**
- **Task Question License**
- **Task Question Attribution**
- **Task Question Citation**
- **Task Question Reference**
- **Task Question Source**
- **Task Question Author**
- **Task Question Contributor**
- **Task Question Editor**
- **Task Question Publisher**
- **Task Question Date**
- **Task Question Location**
- **Task Question Language**
- **Task Question Format**
- **Task Question Size**
- **Task Question Duration**
- **Task Question Frequency**
- **Task Question Priority**
- **Task Question Status**
- **Task Question Category**
- **Task Question Type**
- **Task Question Tag**
- **Task Question Keyword**
- **Task Question Description**
- **Task Question Summary**
- **Task Question Abstract**
- **Task Question Introduction**
- **Task Question Body**
- **Task Question Conclusion**
- **Task Question Appendix**
- **Task Question Glossary**
- **Task Question Index**
- **Task Question Table Of Contents**
- **Task Question List Of Figures**
- **Task Question List Of Tables**
- **Task Question List Of Equations**
- **Task Question List Of Symbols**
- **Task Question List Of Abbreviations**
- **Task Question List Of Acronyms**
- **Task Question List Of Definitions**
- **Task Question List Of Examples**
- **Task Question List Of Exercises**
- **Task Question List Of Solutions**
- **Task Question List Of References**
- **Task Question List Of Appendices**
- **Task Question List Of Glossaries**
- **Task Question List Of Indexes**
- **Task Question List Of Tables Of Contents**

Use action names and parameters as needed.

## Working with Tookan

This skill uses the Membrane CLI to interact with Tookan. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.

### Install the CLI

Install the Membrane CLI so you can run `membrane` from the terminal:

```bash
npm install -g @membranehq/cli@latest
```

### Authentication

```bash
membrane login --tenant --clientName=<agentType>
```

This will either open a browser for authentication or print an authorization URL to the console, depending on whether interactive mode is available.

**Headless environments:** The command will print an authorization URL. Ask the user to open it in a browser. When they see a code after completing login, finish with:

```bash
membrane login complete <code>
```

Add `--json` to any command for machine-readable JSON output.

**Agent Types** : claude, openclaw, codex, warp, windsurf, etc. Those will be used to adjust tooling to be used best with your harness

### Connecting to Tookan

Use `membrane connection ensure` to find or create a connection by app URL or domain:

```bash
membrane connection ensure "https://jungleworks.com/tookan/" --json
```
The user completes authentication in the browser. The output contains the new connection id.

This is the fastest way to get a connection. The URL is normalized to a domain and matched against known apps. If no app is found, one is created and a connector is built automatically.

If the returned connection has `state: "READY"`, skip to **Step 2**.

#### 1b. Wait for the connection to be ready

If the connection is in `BUILDING` state, poll until it's ready:

```bash
npx @membranehq/cli connection get <id> --wait --json
```

The `--wait` flag long-polls (up to `--timeout` seconds, default 30) until the state changes. Keep polling until `state` is no longer `BUILDING`.

The resulting state tells you what to do next:

- **`READY`** — connection is fully set up. Skip to **Step 2**.
- **`CLIENT_ACTION_REQUIRED`** — the user or agent needs to do something. The `clientAction` object describes the required action:
  - `clientAction.type` — the kind of action needed: