Integrations Overview
Audience: Admin, Developer, Strategy Manager
Page Type: Reference + How-To
Integration Approach
COS is designed as an open platform. You can connect COS with your existing systems through:
- REST API — full programmatic access to COS data
- CSV Import/Export — structured data exchange for KPIs, users, and resources
- Webhook Notifications (planned) — push events to external systems when things happen in COS
REST API
COS exposes a REST API that allows external systems to read and write data. Common use cases:
| Use Case | Description |
|---|---|
| KPI data push | Push metric values from your BI tools or data warehouse into COS KPI measurements |
| OKR sync | Read OKR progress data into executive dashboards or reporting tools |
| User provisioning | Sync users from your HR system or identity provider |
| Approval automation | Trigger approval flows from external workflow tools |
Getting started with the API:
- Obtain an API key from Admin → API Keys
- All requests use Bearer token authentication
- Base URL:
https://your-tenant.cos.app/api/v1
Full endpoint reference → API Overview
CSV Import / Export
For non-technical teams, COS supports structured data exchange via CSV files.
Importing KPI Measurements
You can bulk-import KPI measurement values into the KPI Library from a CSV:
- Go to Library → KPI / IPF
- Open the KPI you want to update
- Click Import Measurements
- Download the CSV template (includes: date, value, notes)
- Fill in your measurement data
- Upload and confirm
Exporting OKR Data
Export OKR progress for use in presentations or external reporting:
- Go to OKR → Control Center
- Apply filters as needed (cycle, unit, status)
- Click Export → Excel / CSV
Exporting BSC Data
- Go to your BSC view
- Click Export to download the scorecard in Excel format
Planned Integrations
The following integrations are on the COS roadmap:
| System | Type | Status |
|---|---|---|
| Slack | Notification delivery — OKR check-in reminders, approval alerts | Planned |
| Microsoft Teams | Notification delivery | Planned |
| Google Sheets | KPI measurement sync (bidirectional) | Planned |
| Jira / Linear | Initiative/task tracking sync | Planned |
| Salesforce | CRM KPI sync (revenue, pipeline metrics) | Planned |
| HR systems (BambooHR, Workday) | User provisioning sync | Planned |
To request an integration or vote on priorities, contact support@cos.app.
Webhook Notifications (Coming Soon)
Webhooks will allow COS to push real-time event notifications to external systems.
Planned events:
okr.submitted— OKR submitted for approvalokr.approved/okr.rejected— Approval decision madecheckin.created— New check-in submittedcycle.completed— OKR cycle closed
Webhook endpoints will be configurable from Admin → Integrations → Webhooks.
Security Considerations
All integrations communicate over HTTPS. API keys:
- Are scoped per service (not per user)
- Can be revoked at any time from Admin → API Keys
- Should never be committed to source code repositories — use environment variables