Pluggy Integration
Core Pluggy integration patterns and best practices. Use when setting up Pluggy SDK, implementing Connect Widget, managing Items, or configuring webhooks.
- Skill ID
- pluggyai/agent-skills/pluggy-integration
- Publisher
- pluggyai
- Repository
- agent-skills
- Installs
- 0
- Files
- 12
- License
- MIT
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
pluggyai/agent-skills/pluggy-integrationInstalls these files- AGENTS.md
- SKILL.md
- metadata.json
- rules/auth-api-keys.md
- rules/auth-token-refresh.md
- rules/error-handling.md
- rules/error-mfa.md
- rules/item-delete.md
- rules/item-lifecycle.md
- rules/webhook-setup.md
- rules/widget-integration.md
- rules/widget-update-item.md
What this skill tells the agent
Pluggy Integration
Comprehensive integration guide for Pluggy Open Finance API. Contains rules across 5 categories, prioritized by impact to guide accurate implementation.
When to Apply
Reference these guidelines when:
- Setting up Pluggy SDK and authentication
- Implementing the Connect Widget in frontend applications
- Creating, updating, or managing Items (connections)
- Handling MFA (Multi-Factor Authentication) flows
- Configuring webhooks for real-time data sync
- Managing API keys and tokens
- Handling connection errors and edge cases
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Authentication | CRITICAL | auth- |
| 2 | Connect Widget | CRITICAL | widget- |
| 3 | Webhook Configuration | CRITICAL | webhook- |
| 4 | Item Lifecycle | HIGH | item- |
| 5 | Error Handling | MEDIUM | error- |
How to Use
Read individual rule files for detailed explanations and code examples:
rules/auth-api-keys.md
rules/widget-integration.md
rules/item-lifecycle.mdEach rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references
- Pluggy-specific notes
Key Concepts
Connection Sync vs Data Sync
| Responsibility | Who Handles | How |
|---|---|---|
| Connection sync | Pluggy | Auto-sync every 24/12/8h |
| Triggering updates | User | Only when user explicitly requests |
| Entity data sync | You | Fetch all on item/updated webhook |
| Transaction sync | You | Use transactions/* webhook events |
API Key vs Connect Token
- API Key: Backend token (2h expiration) for accessing user data
- Connect Token: Frontend token (30min expiration) for Connect Widget only
Item Lifecycle
- User opens Connect Widget with Connect Token
- User selects connector and authenticates
- Pluggy creates Item and starts data sync
- Webhook notifies when sync completes
- Backend retrieves data using API Key
- Pluggy auto-syncs daily; webhook triggers data refresh
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
More from pluggyai
Use this skill in a project
Open any RiverX project, search the Skills panel for pluggyai/agent-skills/pluggy-integration, and install it in one click.