Nectar

aid: nectar-hr
url: https://raw.githubusercontent.com/api-evangelist/nectar-hr/refs/heads/main/apis.yml
name: Nectar
kind: company
description: Nectar is an employee recognition and rewards platform that helps organizations build culture through peer-to-peer
  and manager recognition, a points-based global rewards catalog (gift cards, Amazon, swag, custom company rewards), automated
  milestone celebrations, and internal comms. Nectar exposes a documented Open API (base https://api.nectarhr.com, Swagger
  at /docs) covering users, the company recognition feed, custom awards, financial redemption analytics, and Flow triggers.
  The API is an account add-on - access is enabled by Nectar support/your account manager and then a scoped API key is generated
  in Settings > Integrations; all endpoints use Bearer (JWT) authentication.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Employee Recognition
- Rewards
- Points
- HR
- Employee Engagement
- Culture
- People Operations
created: '2026-07-10'
modified: '2026-07-10'
specificationVersion: '0.19'
apis:
- aid: nectar-hr:nectar-hr-users-api
  name: Nectar Users API
  tags:
  - Users
  - People
  - Provisioning
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.nectarhr.com/docs
  baseURL: https://api.nectarhr.com
  properties:
  - url: https://help.nectarhr.com/en/articles/10770969-open-api
    type: Documentation
  - url: https://api.nectarhr.com/docs
    type: APIReference
  - url: openapi/nectar-hr-openapi.yml
    type: OpenAPI
  description: Read and manage the people in a Nectar company. List users with filters (active, invited, email, employee_id)
    via cursor pagination, get a single user by ID, and upsert up to 50 users at a time (matched on nectar_id, email, or employee_id)
    with optional invite sending. Backs HRIS sync and user provisioning workflows.
- aid: nectar-hr:nectar-hr-recognition-api
  name: Nectar Recognition API
  tags:
  - Recognition
  - Feed
  - Engagement
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.nectarhr.com/docs
  baseURL: https://api.nectarhr.com
  properties:
  - url: https://api.nectarhr.com/docs
    type: APIReference
  - url: openapi/nectar-hr-openapi.yml
    type: OpenAPI
  description: Read the company recognition feed - the stream of peer-to-peer and manager recognitions posted in Nectar. Supports
    filtering by type, private, leaderboard visibility, and deleted state, plus date-range and cursor-based pagination for
    exporting recognition activity into analytics or reporting.
- aid: nectar-hr:nectar-hr-custom-awards-api
  name: Nectar Custom Awards API
  tags:
  - Awards
  - Rewards
  - Points
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.nectarhr.com/docs
  baseURL: https://api.nectarhr.com
  properties:
  - url: https://api.nectarhr.com/docs
    type: APIReference
  - url: openapi/nectar-hr-openapi.yml
    type: OpenAPI
  description: List a company's configured custom awards and programmatically send a custom award to one or more recipients
    (valid user UUIDs), with an optional message and point value. Enables automated, points-based recognition and rewards
    from external systems.
- aid: nectar-hr:nectar-hr-financial-analytics-api
  name: Nectar Financial Analytics API
  tags:
  - Analytics
  - Redemptions
  - FinOps
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.nectarhr.com/docs
  baseURL: https://api.nectarhr.com
  properties:
  - url: https://api.nectarhr.com/docs
    type: APIReference
  - url: openapi/nectar-hr-openapi.yml
    type: OpenAPI
  description: Generate a summary of reward redemptions made by all users over a date range (defaulting to the current month
    to date, capped at a one-year span). Powers financial reporting and reconciliation of points-to-rewards spend from the
    Nectar rewards catalog.
- aid: nectar-hr:nectar-hr-flows-api
  name: Nectar Flows API
  tags:
  - Flows
  - Automation
  - Enrollment
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://api.nectarhr.com/docs
  baseURL: https://api.nectarhr.com
  properties:
  - url: https://api.nectarhr.com/docs
    type: APIReference
  - url: openapi/nectar-hr-openapi.yml
    type: OpenAPI
  description: Enroll users in a Nectar Flow via an API trigger. Users are identified by email or userId and must be valid
    company members; if any user is not found the request fails without enrolling anyone, giving all-or-nothing automation
    of onboarding and engagement journeys.
common:
- type: TrustCenter
  url: security/nectar-hr-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/nectar-hr-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/nectar-hr-domain-security.yml
- type: Authentication
  url: authentication/nectar-hr-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/nectarhr
- type: Website
  url: https://nectarhr.com
- type: Documentation
  url: https://api.nectarhr.com/docs
- type: Plans
  url: plans/nectar-hr-plans-pricing.yml
- type: RateLimits
  url: rate-limits/nectar-hr-rate-limits.yml
- type: FinOps
  url: finops/nectar-hr-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com