New Integration: Wrike

Description

Add Wrike integration to sync tasks, projects, folders, and work activity into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/linear/ - Similar project management integration
• integrations/todoist/ - Task management integration
• integrations/github/ - For webhook and event patterns

Required Files Structure

integrations/wrike/
├── src/
│   ├── index.ts          # Main entry, OAuth spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # Wrike API utilities
│   ├── account-create.ts # OAuth setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

Wrike API Integration

OAuth Setup

• Use OAuth 2.0 protocol for authorization
• Every API request must contain the Authorization header with the OAuth 2.0 access token
• Base URL: https://www.wrike.com/api/v4/

Key Endpoints

• GET /api/v4/tasks - List tasks
• GET /api/v4/folders - List folders and projects
• GET /api/v4/contacts - List contacts/users
• GET /api/v4/accounts - Get account information
• GET /api/v4/users/:id - Get user details
• GET /api/v4/timelogs - Get time tracking entries
• GET /api/v4/comments - Get comments
• POST /api/v4/webhooks - Create webhooks for real-time updates
• GET /api/v4/workflows - Get workflows and statuses

Request Methods

• Supports GET, POST, PUT, and DELETE requests (RESTful)

Events to Track

1. Tasks - Task created, updated, completed, deleted, status changes
2. Projects - Project created, updated, completed
3. Folders - Folder created, reorganized
4. Comments - Comments added, edited on tasks/projects
5. Time Tracking - Time entries logged
6. Workflows - Workflow status transitions

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement OAuth 2.0 flow in account-create.ts
• Create API utilities in utils.ts for v4 API
• Implement sync logic in schedule.ts for tasks, projects, and folders
• Set up webhook handling for real-time task and project updates
• Convert Wrike events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• Wrike API v4 is the current version with changes to internal API ID structure
• API supports webhooks for real-time notifications
• Postman collection available with most API endpoints and sample requests
• Schema Reference available for detailed data models
• RESTful architecture supporting standard HTTP methods

Resources

• Wrike API Developer Portal
• Wrike API Overview
• Wrike Tasks API
• Wrike Folders & Projects API
• Wrike API FAQ
• Wrike Help Center - API

Labels

enhancement, integration, new-feature