Navigation
SuperSend

Changelog

A complete history of API changes, new features, and deprecations.


Stay up to date with the latest changes to the SuperSend API. We follow semantic versioning and announce breaking changes in advance.

ℹ️

Subscribe to Updates

Get notified of API changes by watching our GitHub changelog or subscribing to our developer newsletter.

January 2026

January 28, 2026 - Campaign Contact Lifecycle Metrics

Added contact_metrics to V2 campaign endpoints for tracking contact lifecycle status.

Affected Endpoints:

  • GET /v2/campaigns - List campaigns now includes contact_metrics for each campaign

  • GET /v2/campaigns/:id - Get campaign now includes contact_metrics

    • New Fields:

    json
    {
      "contact_metrics": {
        "total": 150,
        "not_started": 50,
        "in_progress": 75,
        "finished": 20,
        "paused": 5
      }
    }

    Use Cases:

  • Auto-refill integrations: Use not_started to know how many contacts are queued

  • Campaign progress tracking: Monitor in_progress vs finished ratios

  • Capacity planning: Track paused contacts awaiting action

    • January 27, 2026 - V2 Bulk Contacts Endpoint

    Added POST /v2/contacts/bulk for bulk importing contacts with V2 standardized responses.

    Features:

  • JSON array or CSV file upload support

  • Up to 50,000 contacts per request

  • Asynchronous processing with upload tracking

  • Proper V2 error codes and response format

    • bash
    curl -X POST 'https://api.supersend.io/v2/contacts/bulk' \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d 700 dark:text-green-400">'{"contacts": [...], "TeamId": "...", "CampaignId": "..."}'

    January 19, 2026 - V2 API General Availability

    The V2 API is now generally available! This release brings significant improvements to consistency, error handling, and developer experience.

    New Features:

  • Consistent response format across all endpoints

  • Improved pagination with has_more field

  • Better error codes with documentation links

  • Team usage analytics endpoint

  • Sender profile management

    • Breaking Changes from V1:

  • Response structure changed (see Migration Guide)

  • Some field names updated for consistency

  • Authentication header format standardized

    • json
    // V2 Response Format
    {
      "success": true,
      "data": { ... },
      "request_id": "req_abc123"
    }

    December 2025

    December 12, 2025 - Email Analytics

  • New email.clicked event includes link URL

    • November 2025

    November 28, 2025 - Campaign Improvements

  • Added A/B testing for email subjects

  • Added scheduling options for campaigns

    • November 15, 2025 - Sender Profiles

  • Introduced sender profile management

  • DKIM and SPF verification status

    • November 8, 2025 - Security Updates

  • Added webhook signature verification

    • October 2025

    October 25, 2025 - V2 API Beta

    The V2 API entered public beta with the following endpoints:

  • POST /v2/contacts

  • GET /v2/contacts

  • GET /v2/contacts/{id}

  • PATCH /v2/contacts/{id}

  • DELETE /v2/contacts/{id}

    • October 18, 2025 - Bulk Operations

  • Added bulk contact import endpoint

  • Support for CSV and JSON formats

  • Background processing for large imports

    • October 10, 2025 - Error Handling

  • Standardized error response format

  • Added error codes for all failure scenarios

  • Added docs_url field linking to relevant documentation

    • API Versioning Policy

    Supported Versions

    VersionStatusSunset Date
    V2Current-
    V1DeprecatedDecember 31, 2026


    Breaking Changes

    We consider the following to be breaking changes:

  • Removing an endpoint or HTTP method

  • Removing or renaming a response field

  • Changing the type of a response field

  • Adding a new required request parameter

  • Changing authentication requirements

    • Non-Breaking Changes

    The following are considered non-breaking and may be made without notice:

  • Adding new optional request parameters

  • Adding new response fields

  • Adding new endpoints

  • Adding new event types

  • Fixing bugs

    • Deprecation Notices

    V1 API Deprecation

    The V1 API is deprecated and will be sunset on December 31, 2026. Please migrate to V2 before this date.

    Timeline:

  • October 2025: V2 beta released

  • January 2026: V2 GA, V1 deprecation notice

  • July 2026: V1 read-only mode

  • December 31, 2026: V1 sunset

    • See the V1 to V2 Migration Guide for detailed migration instructions.

    Need Help?

  • Check our Migration Guide for upgrading from V1

  • Contact support at support@supersend.io

  • Join our Discord community