--- schema_version: "1" id: 7f360ff405589d6dddecbbf4bfb247e4a8f31f8027fa77742e75eb66ea8828cc title: Insurance Person Accounts 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_accounts_create.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_insurance_accounts_create.htm source_site: developer.salesforce.com content_type: documentation content_hash: bec77af1150b757c48cda5c6be0de67d1e005830d036d0aeda1edadb610f3e4c description: Create person accounts and portal users for group census members. The Person Account 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 Person Accounts and Users (POST) Create person accounts and portal users for group census members. The Person Account 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. After the records are created and required permission sets are assigned, members can log into the customer community portal to select plans and complete their individual enrollment based on the digital workflow that's configured by the carrier. ## Special Access Rule To use this API, the org must be enabled with Person Account and you must have Census Management user access. ## Resource /connect/insurance/accounts ## Resource Example Replace {yourInstance} with the My Domain name of your Salesforce org. https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/accounts?createPortalUsers=false ## Available Version 65.0 ## HTTP Methods POST #### See Also - [_Salesforce Help_: Configure Group Benefits Enrollment](https://help.salesforce.com/s/articleView?id=ind.insurance_group_benefits_core_enrollment_configure_intro.htm&language=en_US "Salesforce Help: Configure Group Benefits Enrollment - HTML (New Window)") ## Request Parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`createPortalUsers`	Boolean	Indicates whether to create portal users for the new person accounts (`true`) or not (`false`). The default value is `true`.	Optional	65.0

## 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

Name	Type	Description	Required or Optional	Available Version
`fieldMappings`	Map<String, String>	Map of field API names from the Group Census Member object (key) to the Account object (value).	Optional	65.0
`groupCensusId`	String	ID of the group census that contains the members to process.	Optional	65.0
`groupCensusMemberIdList`	String[]	IDs of the group census members for whom you want to create person accounts and users. If not provided, all members of the specified group census are processed.	Optional	65.0
`matchingKeyList`	String[]	List of field API names on the Group Census Member object that are used to identify and prevent the creation of duplicate person accounts. The default fields are FirstName, LastName, PersonBirthdate, PersonEmail, and PersonGender.	Optional	65.0
`personAccountRecordType`	String	Developer name of the person account record type to use for the new accounts.	Optional	65.0
`userDetails`	Portal User Creation Input	Details to create portal users.	Required if the `createPortalUsers` request parameter is set to `true`.	65.0

## Response Body for POST [Insurance Person Accounts and Users Creation Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_insurance_accounts_and_users_creation_output.htm "Output representation of the person account and user creation process.")