.png)
15Five Integration Guide
Connect 15Five employee engagement and performance data with HR, identity, analytics, and collaboration systems through REST API workflows.
15Five integration options at a glance
15Five provides a REST API for authorized programmatic access to people and performance-related data, including Users, Objectives, Key results, Check-ins, Reviews, and High Fives, subject to the current endpoint catalog and account permissions. API credentials or tokens should be confirmed against the current 15Five documentation and stored in Martini Secrets Management. Dedicated bulk, database, GraphQL, and SOAP interfaces were not confirmed. Broad webhook coverage is also unconfirmed, so scheduled REST synchronization with pagination, checkpoints, throttling, and retries is the dependable planning baseline. Martini can consume the API, transform payloads, apply business rules, and expose controlled APIs for downstream systems.
Common 15Five integration patterns
Common 15Five data objects used in integrations
Authentication and security considerations
Credential handling
15Five API access uses account credentials or API keys or tokens, but the exact header format, lifecycle, and permissions should be confirmed in the current 15Five reference. Martini should store these values in environment-specific Secrets Management and REST API configuration.
Least privilege and sensitive data
Reviews, Check-ins, feedback, and recognition can contain confidential employee information. Restrict credentials, fields, workflow access, and logs to the approved business purpose. Do not assume OAuth 2.0, JWT, or granular scopes unless 15Five confirms them.
Transport and API protection
Use HTTPS for API requests and validate any future callback authentication or signature mechanism before accepting events. Keep vendor credentials separate across development, test, and production environments.
Operational considerations for 15Five integrations
Rate limits and pagination
Confirm 15Five account limits and page-size behavior. Use pagination, bounded queries, limited concurrency, and backoff for HTTP 429 responses, respecting Retry-After when supplied.
Checkpoints and idempotency
Store durable synchronization checkpoints when updated timestamps or filters are available. Use stable object or employee identifiers for idempotent upserts and protect against replayed records or duplicate notifications.
Retries and failures
Retry temporary network, 5xx, and rate-limit failures with backoff. Route authentication, authorization, validation, stale-object, and permanent business-rule failures to an operational error path rather than retrying indefinitely.
Schema changes and testing
Validate required fields, tolerate additive fields where possible, preserve source identifiers, and version mappings when contracts change. Test pagination, empty responses, manager changes, review status transitions, revoked credentials, duplicate processing, and controlled test data.
Why use Martini instead of scripts or point-to-point integrations?
Reusable orchestration
Martini separates 15Five API access from business workflows, allowing the same authenticated configuration, mappings, validation rules, and error paths to support HR, analytics, and collaboration use cases.
Controlled transformation
Instead of duplicating point-to-point scripts, Martini provides centralized mapping, filtering, enrichment, and business rules for Users, Objectives, Key results, Reviews, Check-ins, and High Fives.
Operational reliability
Workflows can combine scheduling, pagination, checkpoints, retries, idempotent writes, and monitoring. This provides a maintainable integration boundary without requiring direct database access or unsupported vendor mechanisms.
API-led access
Martini can expose a controlled API façade so downstream systems use a stable normalized contract while 15Five-specific credentials, schemas, and implementation changes remain within the integration layer.