Benefits Renewal

Overview

As your company grows globally, managing employee benefits becomes increasingly complex. Benefits change every year, and each country has its own offerings, rules, and renewal periods.

The Benefits Renewal API helps you scale benefits management across countries by automating annual renewal flows. Instead of manual enrollment forms, you can:

• Track and manage renewal deadlines across different countries.
• Ensure compliance by locking benefit tiers post-renewal.
• Automate HR workflows and reduce manual errors.

Use case: scale benefits for global hiring

Imagine you are part of a global tech company expanding into multiple countries. As part of your hiring and retention policy, you offer region-specific benefits like health insurance, retirement plans, meal allowances, etc. In this case, using the benefits renewal API, you can:

• Track renewals: get notified when a renewal period opens in a registered country.
• Stay compliant: lock benefit tiers once renewal process is completed.
• Onboard employees smoothly: ensure new hires only see the latest benefit options.

Benefits renewal flow

1. BenefitRenewalRequest creation

A scheduled job creates BenefitRenewalRequest object when:

• A benefit group enter the in_renewal_selection lifecycle.
• The company has contracts covered during the group's renewal period (active now, starting within 3 months, or terminating after coverage ends).

Each of these requests represents the company's interest to renew a benefit group.

2. Renewal request notification

With the help of the benefit_renewal_request.created webhook, partners are notified when a new renewal request is created.

3. Company-scoped endpoints

After a renewal request comes in, you can use the benefits renewal API to:

List benefit renewal requests

The List Benefit Renewal Requests endpoint retrieves all renewal requests for a company.

The response will include benefit group data, renewal period data, default benefit offers, and the number of employees affected by this renewal.

{
  "benefit_renewal_requests": [
    {
      "benefit_group": {
        "country_code": "FRA",
        "id": "03b20f23-06b2-4fe2-8f21-49b445ccc1bb",
        "name": "Health"
      },
      "benefit_renewal_response": {
        "benefit_tier": {
          "description": "A tier for testing purposes",
          "display_cost": "~$100",
          "id": "163d8f6c-2440-4f45-918b-d095f9e0ef79",
          "name": "Premium"
        },
        "updated_at": "2021-07-01T00:00:00Z"
      },
      "coverage_end_date": "2022-07-01",
      "coverage_start_date": "2021-07-01",
      "current_benefit_tier": {
        "description": "A tier for testing purposes",
        "display_cost": "~$100",
        "id": "163d8f6c-2440-4f45-918b-d095f9e0ef79",
        "name": "Premium"
      },
      "id": "0073f4b5-b669-4b4a-b963-2a477f4e75a1",
      "number_of_affected_employees": 10,
      "renewal_selection_end_date": "2021-05-01",
      "renewal_selection_instructions": "We are delighted to announce our new Global Life Insurance plans, now available in 66 countries.\nThis addition is set to significantly enhance the benefits package for your international team.\nSelection Deadline: Review and choose the right Global Life Insurance plan for each country where your team is based by 11:59 PM on December 31, 2023.\nWe offer flexible coverage options from $50,000 to $600,000, so take your time to decide what's best for your team.\nIf you don't make a selection within this period, your team members won't be enrolled in the Global Life Insurance.\nIf you wish to do so anytime next year, please reach out to [email protected]\nFor more information on how benefits work in different countries, check out our Global <a href=\"https://remote.com/benefits-guide/global-life-insurance\">benefits guide</a>.\n",
      "renewal_selection_start_date": "2021-03-01"
    }
  ],
  "current_page": 1,
  "total_count": 1,
  "total_pages": 1
}

If, however, you want details of a specific renewal request, you can call the Show Benefit Renewal Request endpoint and pass the benefit_renewal_request_id to filter the search result.

4. Submit a response

Employers can submit a renewal response by populating and submitting the BenefitRenewalResponse object. To submit this response,

Fetch benefit renewal request schema

Since the benefit selections in the response body need to match the country-specific JSON schema, you can use the Show benefit renewal request schema endpoint and fetch the exact schema used in the request. Make sure to enter the correct benefit_renewal_request_id when making the call.

Submit benefit renewal response

With the right JSON schema, you can call the Updates a Benefit Renewal Request Response endpoint to submit your response to the renewal request. Every response is validated against the schema for that benefit group. This ensures compliance with country-specific requirements and captures localized benefit options.

Once submitted, that tier is locked and the process continues internally within Remote.