{"_id":"@afges/n8n-nodes-helloasso","_rev":"2-67999735c9617c1fffdaaaf28e2aa729","name":"@afges/n8n-nodes-helloasso","dist-tags":{"latest":"0.1.4"},"versions":{"0.0.1":{"name":"@afges/n8n-nodes-helloasso","version":"0.0.1","keywords":["n8n-community-node-package"],"author":{"name":"Charles LESECQ","email":"charles.lesecq@afges.org"},"license":"MIT","_id":"@afges/n8n-nodes-helloasso@0.0.1","maintainers":[{"name":"clesecq","email":"charles@lesecq.eu"}],"homepage":"https://github.com/AFGES/n8n-nodes-helloasso#readme","bugs":{"url":"https://github.com/AFGES/n8n-nodes-helloasso/issues"},"n8n":{"nodes":["dist/nodes/Helloasso/Helloasso.node.js"],"strict":true,"credentials":["dist/credentials/HelloassoOAuth2Api.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"7968c0a6aa6d9ccbc8bc142e7cac05c37c7ab64a","tarball":"https://registry.npmjs.org/@afges/n8n-nodes-helloasso/-/n8n-nodes-helloasso-0.0.1.tgz","fileCount":30,"integrity":"sha512-qL3AO/AnkJTY2FZ4qFxo1B16E95z0kpUvSjsrQOhpKszkdPy0YXvCgj6t3id5amgP8wSyo4ixqzZqodpyHA71g==","signatures":[{"sig":"MEYCIQCNdsYWXTN0z8p1Dp0PL/tBXtwnqQLm6pT3d65U6M80zwIhAMb5DILv9hvUF6uccKhXBoDkfwU1AwrUaucV8VXy7Iw2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112040},"gitHead":"82118cff8e8078506adbc0d48230ccc2023ebd91","scripts":{"dev":"n8n-node dev","lint":"n8n-node lint","build":"n8n-node build","lint:fix":"n8n-node lint --fix","build:watch":"tsc --watch"},"_npmUser":{"name":"clesecq","email":"charles@lesecq.eu"},"repository":{"url":"git+https://github.com/AFGES/n8n-nodes-helloasso.git","type":"git"},"_npmVersion":"11.13.0","description":"A node for building integrations with the Helloasso API in n8n.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"devDependencies":{"eslint":"9.32.0","prettier":"3.6.2","release-it":"^19.0.4","typescript":"5.9.2","@n8n/node-cli":"*"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-helloasso_0.0.1_1780956399970_0.18789398947194091","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@afges/n8n-nodes-helloasso","version":"0.1.4","description":"A node for building integrations with the Helloasso API in n8n.","license":"MIT","homepage":"https://github.com/AFGES/n8n-nodes-helloasso#readme","keywords":["n8n-community-node-package"],"author":{"name":"Charles LESECQ","email":"charles.lesecq@afges.org"},"repository":{"type":"git","url":"git+https://github.com/AFGES/n8n-nodes-helloasso.git"},"scripts":{"build":"n8n-node build","build:watch":"tsc --watch","dev":"n8n-node dev","lint":"n8n-node lint","lint:fix":"n8n-node lint --fix","release":"n8n-node release","prepublishOnly":"n8n-node prerelease"},"n8n":{"n8nNodesApiVersion":1,"strict":true,"credentials":["dist/credentials/HelloassoOAuth2Api.credentials.js"],"nodes":["dist/nodes/Helloasso/Helloasso.node.js"]},"devDependencies":{"@n8n/node-cli":"^0.34.0","eslint":"9.29.0","prettier":"3.8.4","release-it":"^20.2.0","typescript":"6.0.3"},"peerDependencies":{"n8n-workflow":"*"},"gitHead":"94a42f0c16ee9fddfc28a49c843f74510857f801","_id":"@afges/n8n-nodes-helloasso@0.1.4","bugs":{"url":"https://github.com/AFGES/n8n-nodes-helloasso/issues"},"_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-wVtNopiFd/mo4NBrRmYNKvmjb8YjE4fJjEHG4/vXAbZS9a+PjM1FkTIiwH+R6e3UjHwxmVU0AQVklMqAGY1rOw==","shasum":"6ef412082b3a4e61afec049335b3ad52bdfcedce","tarball":"https://registry.npmjs.org/@afges/n8n-nodes-helloasso/-/n8n-nodes-helloasso-0.1.4.tgz","fileCount":54,"unpackedSize":142494,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@afges%2fn8n-nodes-helloasso@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIB8b3pMskMdmlV/LwBtyWXISK44LrFj21Bll82lWgSDcAiBZZjdovazvgNFnKoIyQMKq2WpjMSg0Jy2kCKYGegri3w=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fcad5e2d-48b8-4fcb-8943-97f179b56b44"}},"directories":{},"maintainers":[{"name":"clesecq","email":"charles@lesecq.eu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-helloasso_0.1.4_1781125612589_0.845019933813898"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-08T22:06:39.792Z","modified":"2026-06-10T21:06:53.048Z","0.0.1":"2026-06-08T22:06:40.123Z","0.1.4":"2026-06-10T21:06:52.722Z"},"bugs":{"url":"https://github.com/AFGES/n8n-nodes-helloasso/issues"},"author":{"name":"Charles LESECQ","email":"charles.lesecq@afges.org"},"license":"MIT","homepage":"https://github.com/AFGES/n8n-nodes-helloasso#readme","keywords":["n8n-community-node-package"],"repository":{"type":"git","url":"git+https://github.com/AFGES/n8n-nodes-helloasso.git"},"description":"A node for building integrations with the Helloasso API in n8n.","maintainers":[{"name":"clesecq","email":"charles@lesecq.eu"}],"readme":"# @afges/n8n-nodes-helloasso\n\n> Nœud communautaire n8n pour l'API HelloAsso (v5) — billetterie, dons, adhésions et paiements.\n> n8n community node for the HelloAsso API (v5) — ticketing, donations, memberships and payments.\n\n[Français](#français) · [English](#english)\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.\n\n---\n\n## Français\n\nNœud communautaire [n8n](https://n8n.io) pour interagir avec l'[API HelloAsso v5](https://dev.helloasso.com).\nHelloAsso est la plateforme française de paiement pour les associations (billetterie,\ncampagnes de dons, adhésions, boutiques). Ce nœud permet d'automatiser la lecture et la\ngestion des organisations, formulaires, commandes, paiements, articles et intentions de\npaiement directement dans vos workflows n8n.\n\nBase de l'API : `https://api.helloasso.com/v5/`.\n\n### Installation\n\nSuivez le [guide d'installation des nœuds communautaires](https://docs.n8n.io/integrations/community-nodes/installation/)\nde n8n.\n\nDans n8n : **Settings → Community Nodes → Install**, puis saisissez le nom du paquet :\n\n```\n@afges/n8n-nodes-helloasso\n```\n\nInstallation manuelle (instance auto-hébergée) :\n\n```bash\nnpm install @afges/n8n-nodes-helloasso\n```\n\n### Identifiants (Credentials)\n\nLe nœud utilise des identifiants **HelloAsso OAuth2 API** (flux *Client Credentials*).\n\n1. Créez une application API depuis votre espace HelloAsso et récupérez vos clés :\n   voir la [documentation HelloAsso](https://dev.helloasso.com/docs/getting-started).\n2. Dans n8n, créez des identifiants **HelloAsso OAuth2 API** et renseignez votre\n   **Client ID** et votre **Client Secret**.\n3. Le reste est préconfiguré :\n   - Type d'autorisation : *Client Credentials*\n   - URL du jeton : `https://api.helloasso.com/oauth2/token`\n   - Authentification dans le corps de la requête (*body*), aucun *scope* requis.\n\nLes identifiants sont validés via un appel à `GET /v5/users/me/organizations`.\n\n### Opérations\n\n| Ressource | Opérations | Description |\n|-----------|------------|-------------|\n| **Organisation** (Organization) | Get | Récupère une organisation par son *slug*. |\n| **Formulaire** (Form) | Get Many · Get Public Data | Liste les formulaires (filtres : types, états ; pagination) ; récupère les données publiques d'un formulaire. |\n| **Commande** (Order) | Get · Get Many · Cancel | Récupère, liste (filtres : types de formulaire, plage de dates, recherche, détails) ou annule une commande. |\n| **Paiement** (Payment) | Get · Get Many · Refund | Récupère, liste (filtres : états, plage de dates, recherche) ou rembourse un paiement (total/partiel). |\n| **Article** (Item) | Get · Get Many | Récupère ou liste les articles de commande. |\n| **Intention de paiement** (Checkout Intent) | Create · Get | Crée une intention de paiement (montants en centimes, URLs de retour/erreur/abandon, métadonnées) et renvoie l'URL de redirection ; récupère une intention. |\n\n### Fonctionnalités\n\n- **Sélecteur d'organisation** : choisissez dans une liste déroulante de vos organisations\n  (chargée automatiquement) ou saisissez manuellement le *slug*\n  (ex. : `helloasso.com/associations/<slug>`).\n- **Pagination** : option *Return All* pour tout récupérer, ou *Limit* pour borner le\n  nombre de résultats (pagination par *continuation token* de l'API v5).\n- **Filtres avancés** : plages de dates, recherche texte (nom/email du payeur), types de\n  formulaire, états de paiement.\n- Le nœud est utilisable comme **outil** (`usableAsTool`) dans les workflows IA d'n8n.\n\n### Compatibilité\n\n- API des nœuds n8n version 1, mode `strict`.\n- Nécessite une instance n8n prenant en charge les nœuds communautaires.\n\n### Exemple d'utilisation\n\n1. Ajoutez le nœud **HelloAsso** et sélectionnez vos identifiants.\n2. Ressource **Order** (Commande) → opération **Get Many**.\n3. Choisissez votre **Organisation** dans la liste déroulante.\n4. Ajoutez un filtre *From Date* / *To Date* pour ne récupérer que les commandes d'une\n   période donnée.\n\n### Ressources\n\n- [Documentation des nœuds communautaires n8n](https://docs.n8n.io/integrations/community-nodes/)\n- [Documentation de l'API HelloAsso](https://dev.helloasso.com/docs/getting-started)\n- [Dépôt GitHub](https://github.com/AFGES/n8n-nodes-helloasso)\n\n### Historique des versions\n\nVoir [CHANGELOG.md](CHANGELOG.md). Version actuelle : **0.0.5**.\n\n### Licence\n\n[MIT](https://opensource.org/licenses/MIT).\n\n---\n\n## English\n\n[n8n](https://n8n.io) community node for the [HelloAsso v5 API](https://dev.helloasso.com).\nHelloAsso is the French payment platform for nonprofits (ticketing, donation campaigns,\nmemberships, shops). This node lets you automate reading and managing organizations, forms,\norders, payments, items and checkout intents directly inside your n8n workflows.\n\nAPI base: `https://api.helloasso.com/v5/`.\n\n### Installation\n\nFollow n8n's [community node installation guide](https://docs.n8n.io/integrations/community-nodes/installation/).\n\nIn n8n: **Settings → Community Nodes → Install**, then enter the package name:\n\n```\n@afges/n8n-nodes-helloasso\n```\n\nManual install (self-hosted instance):\n\n```bash\nnpm install @afges/n8n-nodes-helloasso\n```\n\n### Credentials\n\nThe node uses **HelloAsso OAuth2 API** credentials (*Client Credentials* flow).\n\n1. Create an API application from your HelloAsso account and get your keys:\n   see the [HelloAsso documentation](https://dev.helloasso.com/docs/getting-started).\n2. In n8n, create **HelloAsso OAuth2 API** credentials and fill in your\n   **Client ID** and **Client Secret**.\n3. Everything else is preconfigured:\n   - Grant type: *Client Credentials*\n   - Token URL: `https://api.helloasso.com/oauth2/token`\n   - Body authentication, no scopes required.\n\nCredentials are validated with a call to `GET /v5/users/me/organizations`.\n\n### Operations\n\n| Resource | Operations | Description |\n|----------|------------|-------------|\n| **Organization** | Get | Get an organization by its slug. |\n| **Form** | Get Many · Get Public Data | List forms (filters: types, states; pagination); get the public data of a form. |\n| **Order** | Get · Get Many · Cancel | Get, list (filters: form types, date range, search, with details) or cancel an order. |\n| **Payment** | Get · Get Many · Refund | Get, list (filters: states, date range, search) or refund a payment (full/partial). |\n| **Item** | Get · Get Many | Get or list order items. |\n| **Checkout Intent** | Create · Get | Create a checkout intent (amounts in cents, return/error/back URLs, metadata) and get its redirect URL; get an intent. |\n\n### Features\n\n- **Organization picker**: pick from a dropdown of your organizations (loaded\n  automatically) or enter the slug manually\n  (e.g. `helloasso.com/associations/<slug>`).\n- **Pagination**: *Return All* to fetch everything, or *Limit* to cap the number of\n  results (v5 API continuation-token pagination).\n- **Advanced filters**: date ranges, text search (payer name/email), form types,\n  payment states.\n- The node is **usable as a tool** (`usableAsTool`) in n8n AI workflows.\n\n### Compatibility\n\n- n8n nodes API version 1, `strict` mode.\n- Requires an n8n instance that supports community nodes.\n\n### Usage example\n\n1. Add the **HelloAsso** node and select your credentials.\n2. Resource **Order** → operation **Get Many**.\n3. Choose your **Organization** from the dropdown.\n4. Add a *From Date* / *To Date* filter to fetch only the orders of a given period.\n\n### Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n- [HelloAsso API documentation](https://dev.helloasso.com/docs/getting-started)\n- [GitHub repository](https://github.com/AFGES/n8n-nodes-helloasso)\n\n### Version history\n\nSee [CHANGELOG.md](CHANGELOG.md). Current version: **0.0.5**.\n\n### License\n\n[MIT](https://opensource.org/licenses/MIT).\n","readmeFilename":"README.md"}