---
schema_version: "1"
id: 8364286ec689226763863b3bc27496433f2f51eb48fe0c52d32359a8aaedf0ab
title: Insurance Contacts and Users (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_insurance_create_contacts.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_insurance_create_contacts.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8bb9abd5dd2bc7ec69c27e8ee9138dda10e98d9244b55125039c527b576aa77c
description: Create contacts and portal users for group census members. The Contact record is used for linking to the appropriate policy for policy association, and the corresponding portal user is created to allow the member to log in to the community portal.
---
# Insurance Contacts and Users (POST)

Create contacts and portal users for group census members. The Contact record is used for linking to the appropriate policy for policy association, and the corresponding portal user is created to allow the member to log in to the community portal.

## Resource

/connect/insurance/contacts

## Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org.

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/contacts?createPortalUsers=false

## Available Version

65.0

## HTTP Methods

POST

## Request Parameters for POST

<table class="featureTable sort_table" summary="">





            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d351542e118">Parameter Name</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e121">Type</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e124">Description</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e127">Required or Optional</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e130">Available Version</th>

              </tr>

            </thead>

            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d351542e118" data-title="Parameter Name"><samp class="codeph nolang">createPortalUsers</samp></td>

                <td class="entry" headers="d351542e121" data-title="Type">Boolean</td>

                <td class="entry" headers="d351542e124" data-title="Description">Indicates whether to create portal users for the new contacts (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>).<p class="p">The default value is <samp class="codeph nolang">true</samp>.</p>
                </td>

                <td class="entry" headers="d351542e127" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e130" data-title="Available Version">65.0</td>

              </tr>

            </tbody>

          </table>

## Request Body for POST

### JSON Example

This is a sample JSON example with GroupCensusId.

{
  "groupCensusId": "0rfxx0000000007AAA",
  "matchingKeyList": {
    "values": \[
      "FirstName",
      "LastName"
    \]
  },
  "fieldMappings": {
    "data": {
      "FirstName": "FirstName",
      "Lastname": "LastName"
    }
  },
  "userDetails": {
    "profileId": "00exx000000mzxC",
    "localeSidKey": "en\_US",
    "timeZoneSidKey": "America/New York",
    "languageLocaleKey": "en\_US",
    "emailEncodingKey": "UTF-8"
  }
}

This is a sample JSON example with GroupCensusMembers.

{
  "groupCensusMemberIdList": {
    "values": \[
      "0r6xx0000000002AAA",
      "0r6xx000000004rAAA"
    \]
  },
  "matchingKeyList": {
    "values": \[
      "FirstName",
      "LastName"
    \]
  },
  "fieldMappings": {
    "data": {
      "FirstName": "FirstName",
      "Lastname": "LastName"
    }
  },
  "userDetails": {
    "profileId": "00exx000000mzxC",
    "localeSidKey": "en\_US",
    "timeZoneSidKey": "America/New York",
    "languageLocaleKey": "en\_US",
    "emailEncodingKey": "UTF-8"
  }
}

### Properties

<table class="featureTable sort_table" summary="">





            <thead class="thead sorted" align="left">
              <tr>
                <th class="featureTableHeader vertical-align-top " id="d351542e222">Name</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e225">Type</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e228">Description</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e231">Required or Optional</th>

                <th class="featureTableHeader vertical-align-top " id="d351542e234">Available Version</th>

              </tr>

            </thead>

            <tbody class="tbody">
              <tr>
                <td class="entry" headers="d351542e222" data-title="Name"><samp class="codeph nolang">fieldMappings</samp></td>

                <td class="entry" headers="d351542e225" data-title="Type">Map</td>

                <td class="entry" headers="d351542e228" data-title="Description">Map of field API names from the Group Census Member object (key) to the Contact
                  object (value).</td>

                <td class="entry" headers="d351542e231" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e234" data-title="Available Version">65.0</td>

              </tr>

              <tr>
                <td class="entry" headers="d351542e222" data-title="Name"><samp class="codeph nolang">groupCensusId</samp></td>

                <td class="entry" headers="d351542e225" data-title="Type">String</td>

                <td class="entry" headers="d351542e228" data-title="Description">ID of the group census.</td>

                <td class="entry" headers="d351542e231" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e234" data-title="Available Version">65.0</td>

              </tr>

              <tr>
                <td class="entry" headers="d351542e222" data-title="Name"><samp class="codeph nolang">groupCensusMember​IdList</samp></td>

                <td class="entry" headers="d351542e225" data-title="Type">String[]</td>

                <td class="entry" headers="d351542e228" data-title="Description">IDs of the group census members for whom you want to create contacts and
                  users.
                  <p class="p">If not provided, all members of the specified group census are
                    processed.</p>

                </td>

                <td class="entry" headers="d351542e231" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e234" data-title="Available Version">65.0</td>

              </tr>

              <tr>
                <td class="entry" headers="d351542e222" data-title="Name"><samp class="codeph nolang">matchingKeyList</samp></td>

                <td class="entry" headers="d351542e225" data-title="Type">String[]</td>

                <td class="entry" headers="d351542e228" data-title="Description">List of field API names on the Group Census Member object that are used to identify
                  and prevent the creation of duplicate contact records.
                  <p class="p">The default fields
                    are FirstName, LastName, Birthdate, Email, and Gender.</p>

                </td>

                <td class="entry" headers="d351542e231" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e234" data-title="Available Version">65.0</td>

              </tr>

              <tr>
                <td class="entry" headers="d351542e222" data-title="Name"><samp class="codeph nolang">userDetails</samp></td>

                <td class="entry" headers="d351542e225" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_portal_user_creation_input.htm" title="Input representation for the details to create a portal user.">Portal User Creation Input</a></td>

                <td class="entry" headers="d351542e228" data-title="Description">Details to create portal users.
                  <p class="p">This property is required if the <samp class="codeph nolang">createPortalUsers</samp> parameter in the method call is set to

                    <samp class="codeph nolang">true</samp>.
                  </p>

                </td>

                <td class="entry" headers="d351542e231" data-title="Required or Optional">Optional</td>

                <td class="entry" headers="d351542e234" data-title="Available Version">65.0</td>

              </tr>

            </tbody>

          </table>

## Response Body for POST

[Insurance Contacts and Users Creation Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_insurance_contacts_and_users_creation_output.htm "Output representation of the contact and user creation process.")