n8n-nodes-yext

Community node package for integrating Yext APIs into n8n workflows.

Current Version: v0.1.6 ✅ All 11 nodes working (Optimal dependency structure)

Features

This package provides n8n nodes for all major Yext APIs:

- Yext Admin API - Account and location management (94 operations)
- Yext Answers API - Search and recommendations engine (79 operations)
- Yext Chat API - AI-powered chat experiences (11 operations)
- Yext Events API - Analytics events tracking (28 operations)
- Yext Knowledge API - Entity and knowledge management (1,192 operations)
- Yext Live API - Real-time location data (180 operations)
- Yext Publisher ECL API - Publisher Edge Content List API (3 operations)
- Yext Publisher Listings API - Listings management across publishers (124 operations)
- Yext Publisher Notify Review API - Review notifications (13 operations)
- Yext Publisher Tracking Pixel API - Tracking pixel management (3 operations)
- Yext Webhooks - Event webhooks and notifications (65 operations)

Total: 1,770+ API operations available

Installation

1. In n8n, go to Settings > Community Nodes
2. Search for n8n-nodes-yext
3. Click Install
4. Restart n8n completely (important!)

Or install via npm:
``bash
npm install n8n-nodes-yext@latest
`

Troubleshooting

If you encounter errors during installation:

1. Update to v0.1.6 or later (Recommended)
- v0.1.6: Optimized dependency structure (matches n8n-nodes-epic pattern)
- v0.1.5: Fixed "Cannot find module 'real-require'" error
- v0.1.4: Fixed "No operations found in OpenAPI document" error
- Earlier versions had module loading issues

2. Restart n8n completely
- Close browser completely and reopen
- Or restart n8n service/container
- Clear browser cache (Ctrl+Shift+Delete)

3. Verify installation
- Run npm list n8n-nodes-yext and confirm v0.1.6+

For detailed troubleshooting, see TROUBLESHOOTING.md

Authentication

All nodes require a Yext API Key for authentication:

1. Create a Yext developer account at https://www.yext.com/
2. Go to Developer Console and create an App
3. Copy your API Key
4. In n8n, create a new Yext credential and paste your API Key
5. Also provide your Account ID (found in Developer Console)

For more details, see docs/auth.md

Usage

1. Add any Yext node to your workflow
2. Select "Yext API" from the Credentials dropdown
3. Choose a Resource (e.g., "Locations" in Admin API)
4. Choose an Operation (e.g., "List" to get all locations)

5. Configure any required parameters
6. Execute your workflow

API Documentation

- Yext API Docs
- Getting Started Guide
- Rate Limits

Rate Limits

By default, Yext allows 10,000 requests per hour. Check the rate limit headers in responses:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset`

Support

For issues or feature requests, please open an issue on the GitHub repository.

License

MIT