npm package: @limego/n8n-nodes-lime-go
Description: n8n node to connect to Lime Go public api
Author: Lime Technologies
Latest version: 1.4.0

# n8n-nodes-lime-go

n8n community node for [Lime Go CRM](https://www.lime-technologies.com/lime-go/) API integration.

[npm](https://www.npmjs.com/package/@limego/n8n-nodes-lime-go) | [Lime Go API Reference](https://lime-go.readme.io/reference/getting-started) | [GitHub](https://github.com/Lundalogik/lime-go-n8n)

## Installation

### Using n8n Community Nodes UI (Recommended)

1. Go to **Settings** > **Community Nodes**
2. Click **Install a community node**
3. Enter `@limego/n8n-nodes-lime-go`
4. Click **Install**

### Using npm

```bash
cd ~/.n8n/custom
npm install @limego/n8n-nodes-lime-go
```

Then restart n8n.

## Credentials

Before using the nodes, you need to configure your Lime Go credentials:

1. Go to **Settings** > **Credentials**
2. Click **Add Credential** and search for "Lime Go API"
3. Fill in:
    - **Server URL**: Your Lime Go API base URL (e.g., `https://api.lime-go.com/v1/`)
    - **API Key**: Your Lime Go API key

> Note: The Server URL must include the `/v1/` path.

## Nodes

This package includes two nodes:

### Lime Go (Action Node)

Perform operations on Lime Go resources.

| Resource      | Operations                                                          |
| ------------- | ------------------------------------------------------------------- |
| Deals         | Create with pipeline, products, tags; get by ID                     |
| Events        | Webhook subscriptions, event feeds                                  |
| GraphQL       | Query and update organizations, persons, deals with field selection |
| Organizations | Find by name, get by ID, create with postal address                 |
| Persons       | Get by ID                                                           |
| Signal        | Send buy-signals (leads)                                            |
| Ping          | Test connection                                                     |

#### GraphQL Operations

The GraphQL resource provides advanced querying and mutation capabilities:

| Operation           | Features                                                          |
| ------------------- | ----------------------------------------------------------------- |
| Query Organizations | Search with filters, select return fields, nested address data    |
| Query Persons       | Search with filters, select return fields, employer data          |
| Query Deals         | Search with filters, select return fields, customer/coworker data |
| Update Organization | Update relation, tags, responsible coworker, external key         |
| Update Person       | Update email, email consent, tags                                 |
| Update Deal         | Update value, status, tags, responsible coworker                  |

Features:

- Dynamic field selection
- Nested field support (addresses, related entities)
- External key support for custom identifiers
- Tag management via comma-separated input
- Flexible relation input formats

### Lime Go Trigger (Trigger Node)

Start workflows automatically when events occur in Lime Go.

| Feature                 | Description                                                      |
| ----------------------- | ---------------------------------------------------------------- |
| Automatic Subscriptions | Creates/deletes webhook subscriptions when workflow is activated |
| Event Types             | 13 event types across deals, organizations, calls, and meetings  |
| Filters                 | Filter by organization ID, deal ID, or event type                |

**Supported Events:**

- **Deal**: won, lost, status changed
- **Organization**: is a customer, was a customer, working on it, been in touch, no relation
- **Call**: positive, negative
- **Meeting**: booked, reported, cancelled

## Requirements

- n8n version 1.0.0 or later
- Lime Go API key

## License

[Apache-2.0](LICENSE)

## Contributing

Contributions are welcome! Please see the [GitHub repository](https://github.com/Lundalogik/lime-go-n8n) for development setup instructions.

## Support

- [GitHub Issues](https://github.com/Lundalogik/lime-go-n8n/issues)
- [Lime Go Documentation](https://lime-go.readme.io/)