Changelog

Stay up to date with the latest features, improvements, and API changes.

📬 Stay Updated

Get notified about important API changes and new features.

Subscribe to Updates

v2.0.0

Latest June 5, 2025

🎉 Major Release

Complete platform redesign with enhanced monitoring capabilities and improved developer experience.

✨ New Features

  • Company monitoring: Track company changes including headcount and descriptions
  • Content tracking: Monitor posts, comments, and reactions from contacts
  • Bulk operations: Create and delete multiple subscriptions in one API call
  • Webhook security: HMAC-SHA256 signatures for all webhook deliveries
  • Search API: Search subscriptions by LinkedIn URL or ID
  • Console dashboard: New web interface for managing subscriptions

🔧 Improvements

  • Increased webhook delivery reliability with automatic retries
  • Improved API response times by 40%
  • Enhanced error messages with actionable details
  • Better LinkedIn URL validation and normalization

🔄 API Changes

  • POST /api/v1/subscriptions/bulk - New bulk create endpoint
  • DELETE /api/v1/subscriptions/bulk - New bulk delete endpoint
  • GET /api/v1/subscriptions?search=query - Added search parameter
  • PUT /api/v1/webhooks/configure - Update webhook configuration
  • POST /api/v1/webhooks/rotate-secret - Rotate webhook secret

Breaking Change: Webhook payload structure updated. Please review the new format in the API documentation.

v1.5.0

December 15, 2024

✨ New Features

  • Webhook testing: Test endpoint to verify webhook configuration
  • Usage API: Track API usage and subscription metrics
  • Delivery logs: View webhook delivery history and debug failures

🔧 Improvements

  • Added X-RateLimit-* headers to all API responses
  • Improved webhook retry logic with exponential backoff
  • Enhanced subscription validation for better error messages

🐛 Bug Fixes

  • Fixed duplicate webhook deliveries in edge cases
  • Resolved timezone issues in event timestamps
  • Fixed pagination offset calculation for large result sets

v1.4.0

November 1, 2024

✨ New Features

  • API key management: Create and revoke API keys via API
  • Webhook events filtering: Subscribe to specific event types only
  • Initial webhooks: Get current state when creating subscriptions

🔧 Improvements

  • Reduced false positive change detections by 60%
  • Improved LinkedIn URL parsing and validation
  • Added request ID to all API responses for debugging

v1.3.0

September 20, 2024

✨ New Features

  • Pause/resume subscriptions: Temporarily pause monitoring
  • Custom metadata: Attach your own data to subscriptions
  • Batch status updates: Update multiple subscription statuses

🐛 Bug Fixes

  • Fixed webhook signature verification with Unicode characters
  • Resolved memory leak in long-running webhook processors
  • Fixed race condition in concurrent subscription creation

API Versioning

Sales Webhooks follows semantic versioning for API changes:

  • Major versions (X.0.0): May include breaking changes
  • Minor versions (1.X.0): New features, backwards compatible
  • Patch versions (1.0.X): Bug fixes only

We maintain backwards compatibility within major versions. Breaking changes are announced at least 90 days in advance.

Deprecation Policy

Our Commitment

  • • 90-day notice: Minimum warning before removing features
  • • Migration guides: Detailed instructions for transitions
  • • Sunset headers: X-API-Deprecation warnings in responses
  • • Email notifications: Direct communication about changes affecting you

Migration Guides

Migrating from v1.x to v2.0

The v2.0 release includes several breaking changes to improve consistency and functionality:

1. Webhook Payload Structure

The webhook payload has been standardized across all event types:

v1.x Format:

{
  "subscription_id": "sub_123",
  "type": "job_change",
  "data": {
    "old_title": "Manager",
    "new_title": "Director"
  }
}

v2.0 Format:

{
  "id": "evt_456",
  "type": "contact.position_changed",
  "created": 1705835400,
  "data": {
    "entity": {
      "id": "sub_123",
      "type": "contact"
    },
    "changes": {
      "previous_title": "Manager",
      "current_title": "Director"
    }
  }
}

2. API Endpoint Changes

  • /api/contacts → /api/v1/subscriptions
  • /api/companies → /api/v1/subscriptions
  • Use entity_type parameter to specify contact or company

3. Authentication Header

Changed from Authorization: Bearer token to X-API-Key: token

Feedback & Feature Requests

We'd love to hear from you! Share your feedback and feature requests: