Create Claim Action | Insurance Developer Guide

This action is available in API version 65.0 and later.

Supported REST HTTP Methods

URI: /services/data/v66.0/actions/standard/createClaim
Formats: JSON
HTTP Methods: POST
Authentication: Authorization: Bearer token

Inputs

Input	Details
createClaimInputRepresentation	Type Apex-defined Description Required. An Apex ConnectApi.CreateClaimInputRepresentation record that contains the details of the claim to be created.

Outputs

Output	Details
`claimId`	Type string Description ID of the claim that's created.

Example

Sample Request

1{
2  "inputs": [
3    {
4      "createClaimInputRepresentation": {
5        "name": "Claim for Auto Accident",
6        "lossDate": "2025-09-15",
7        "claimType": "Auto",
8        "incidentTypeId": "0itxx000000001dEAA",
9        "claimReason": "Rear-end collision",
10        "claimReasonType": "Accident",
11        "lossType": "Accident",
12        "insurancePolicyId": "0YTx0000000001qEAA",
13        "accountId": "001xx000003DGQyAAO",
14        "additionalFields": {
15          "key": "RepairShop",
16          "value": "NY"
17        },
18        "attributes": [
19          {
20            "apiName": "WeatherConditions",
21            "value": "Clear and Sunny"
22          },
23          {
24            "apiName": "NumberOfVehicles",
25            "value": "2"
26          }
27        ],
28        "items": [
29          {
30            "instanceKey": "item_vehicle_damage_01",
31            "name": "Damaged Rear Bumper and Trunk",
32            "productCode": "AUTO-SEDAN-2023",
33            "category": "Auto Physical Damage",
34            "insuredItemId": "02ixx0000004l5sAAA",
35            "insurancePolicyCoverageId": "0cvxx000000AbCdEfG",
36            "attributes": [
37              {
38                "apiName": "DamageSeverity",
39                "value": "Moderate"
40              }
41            ],
42            "additionalFields": {
43              "key": "RepairEstimate",
44              "value": 2750
45            },
46            "relatedObjects": [
47              {
48                "relatedRecordId": "001xx000003DGQzAAP",
49                "relatedRecordObjName": "Account"
50              }
51            ],
52            "participantInstanceKey": "participant_driver_01"
53          }
54        ],
55        "participants": [
56          {
57            "instanceKey": "participant_driver_01",
58            "contactId": "003xx000003DGQyAAO",
59            "accountId": "001xx000003DGQyAAO",
60            "insurancePolicyParticipantId": "0pPxx000000001qEAA",
61            "isInjured": false,
62            "roles": [
63              "Driver",
64              "Claimant"
65            ],
66            "additionalFields": {
67              "StatementTaken": true
68            }
69          }
70        ]
71      }
72    }
73  ]
74}

Sample Response

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