Renew Insurance Brokerage Policy Action

This action is available in API version 67.0 and later.

Special Access Rules

The Renew Insurance Brokerage Policy action is available in Enterprise, Unlimited, and Developer Editions where Financial Service Cloud and Insurance Brokerage are enabled. To use this action, you need the Insurance Brokerage User permission set.

Supported REST HTTP Methods

URI

/services/data/v67.0/actions/standard/renewInsBrokeragePolicy

Formats

JSON, XML

HTTP Methods

POST

Authentication

Authorization: Bearer token

Inputs

Outputs

Example

POST

This sample request is for the Renew Insurance Brokerage Policy action.

1{
2  "inputs": [
3    {
4      "inputRep": {
5        "policyId": "0YjXX0000000001",
6        "effectiveFromDate": "2027-01-01",
7        "effectiveToDate": "2028-01-01",
8        "policyName": "Renewed Policy 2027",
9        "policyNumber": "POL-2027-RENEW"
10      }
11    }
12  ]
13}

This is a sample request to call this invocable action from Apex code.

1// Create the standard Invocable Action for renewing a brokerage policy
2Invocable.Action action = Invocable.Action.createStandardAction('renewInsBrokeragePolicy');
3
4// Instantiate the input object
5ConnectApi.RenewBrokeragePolicyIAInputRep input = new ConnectApi.RenewBrokeragePolicyIAInputRep();
6
7// Required: Set the Policy ID of the original brokerage policy to renew
8input.policyId = '0YjXX0000000001';
9
10// Optional: Set renewal details
11input.effectiveFromDate = '2027-01-01';
12input.effectiveToDate = '2028-01-01';
13input.policyName = 'Renewed Policy 2027';
14input.policyNumber = 'POL-2027-RENEW';
15
16// Set the invocation parameter and invoke
17action.setInvocationParameter('renewBrokeragePolicyIAInputRep', input);
18List<Invocable.Action.Result> results = action.invoke();
19
20System.debug('Renew Brokerage Policy Invocable Action result = ' + results);

This is the sample response for the Renew Insurance Brokerage Policy action.

1[
2  {
3    "actionName": "renewInsBrokeragePolicy",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outcome": null,
8    "outputValues": {
9      "renewedPolicyId": "0YjXX0000000100"
10    },
11    "sortOrder": -1,
12    "version": 1
13  }
14]