postInsuranceCreateContacts(createContactsInputParam, createPortalUsers)

Create contacts and portal users for group census members.

API Version

65.0

Requires Chatter

Signature

public static ConnectApi.InsuranceContactsAndUsersCreationRepresentation postInsuranceCreateContacts(ConnectApi.InsuranceContactsAndUsersCreationInputRepresentation createContactsInputParam, Boolean createPortalUsers)

Parameters

createContactsInputParam

Type: ConnectApi.InsuranceContactsAndUsersCreationInputRepresentation
Details to create contacts and users.

createPortalUsers

Type: Boolean
Indicates whether to create portal users for the new contacts (true) or not (false). The default value is false.

Return Value

Type: ConnectApi.InsuranceContactsAndUsersCreationRepresentation

Example

Here’s an example of how to invoke the Insurance Create Contracts API from Apex code.

1// Create Group Benefits Contract via Connect API (simple version)
2
3// 1) Create the top-level input
4ConnectApi.InsuranceContractCreationInputRepresentation input =
5    new ConnectApi.InsuranceContractCreationInputRepresentation();
6
7// Required: Quote Id to convert
8input.quoteId = '0Q0xx0000004C9QCAU';
9
10// Optional dates (ISO-8601 strings)
11input.contractStartDate = '2026-01-01';
12input.contractEndDate   = '2026-12-31';
13input.enrollmentStartDate = '2025-12-01';
14input.enrollmentEndDate   = '2025-12-31';
15// Optional: contract term in months
16// input.contractTerm = 12;
17
18// 2) (Optional) Additional fields per contract item (e.g., per quote line)
19// Build a map-like structure using InsuranceApexStringMapInputRepresentation
20List<ConnectApi.InsuranceApexStringRepresentation> fieldPairs = new List<ConnectApi.InsuranceApexStringRepresentation>();
21ConnectApi.InsuranceApexStringRepresentation kv1 = new ConnectApi.InsuranceApexStringRepresentation();
22kv1.key = 'CustomerSignedTitle';
23kv1.value = 'Mr';
24fieldPairs.add(kv1);
25
26// One contract item (repeat and add to the list for more)
27ConnectApi.ContractItem item = new ConnectApi.ContractItem();
28item.entity = 'Contract';   // e.g., 'ContractLineItem__c' (use your org’s API name)
29// item.instanceKey = 'QLI-1';                     // unique identification key from Quote Line Item
30item.fields = fieldPairs;
31
32// Wrap into list and assign to input.additionalFields
33input.additionalFields = new List<ConnectApi.ContractItem>{ item };
34
35// 3) Execute the Contract Creation API
36try {
37    ConnectApi.InsuranceContractCreationOutputRepresentation result =
38        ConnectApi.InsuranceGroupBenefitsFamily.postInsuranceGBQuoteToContract(input);
39
40    System.debug('Contract creation result: ' + JSON.serializePretty(result));
41} catch (Exception e) {
42    System.debug('Error while creating contract: ' + e.getMessage());
43}