Group Definitions (POST)

Define a party relationship group of individuals or trusts to deliver support services or to manage shared processes, such as cases and benefits.

Resource 

1/connect/group/group-definitions

Resource Example 

1https://yourInstance.salesforce.com/services/data/v68.0/connect/group/group-definitions

Available Version 

58.0

Requires Chatter 

No

HTTP Methods 

POST

Request Body for POST 

JSON Example 

1{
2    "accountDetail":{
3       "name":"prg5",
4       "ownerId":"005xx000001X7tNAAS",
5       "billingAddress":{
6          "street":"",
7          "city":"Los Angeles",
8          "state":"California",
9          "country":"USA",
10          "postalCode":"90042"
11       },
12       "shippingAddress":{
13          "street":"",
14          "city":"Los Angeles",
15          "state":"California",
16          "country":"USA",
17          "postalCode":"90042"
18       },
19       "phone":"0123456789"
20    },
21    "groupDetail":{
22       "name":"prg5",
23       "category":"Staying under the same roof",
24       "type":"Household",
25       "groupSize":"2",
26       "groupIncome":"20000",
27       "primaryAddress":{
28          "street":"",
29          "city":"Los Angeles",
30          "state":"California",
31          "country":"USA",
32          "postalCode":"90042"
33       }
34    },
35    "member":{
36       "records":[
37          {
38             "contactId":"003xx000004WhHQAA0",
39             "roles":"Decision Maker",
40             "relations":[
41                {
42                   "roleRelationId":"0zlxx0000000001AAA",
43                   "relatedContactId":"003xx000004WhJ2AAK",
44                   "startDate":"2023-06-14T00:00:00.000Z"
45                }
46             ]
47          }
48       ]
49    },
50    "externalMember":{
51       "records":[
52          {
53             "contactId":"003xx000004WhJ2AAK",
54             "roles":"Decision Maker"
55          }
56       ]
57    },
58    "relatedGroup":{
59       "relations":[
60          {
61             "type":"Direct",
62             "roleRelationId":"0zlxx000000001dAAA",
63             "relatedAccountId":"001xx000003GYodAAG"
64          }
65       ]
66    },
67    "relatedAccount":{
68       "relations":[
69
70       ]
71    }
72 }

Properties 

NameTypeDescriptionRequired or OptionalAvailable Version
account​DetailMap<String, Object>Account details associated with the party relationship group.Required58.0
external​MemberMember Record Input[]External member details of the party relationship group.Optional58.0
group​DetailMap<String, Object>Party relationship group details, such as group size, group income, address, and associated custom fields.Required58.0
memberMember Record Input[]Member details of the party relationship group being created.Required58.0
related​AccountAccount Relation Input[]Data of the account that’s related to the party relationship group being created.Optional58.0
related​GroupAccount Relation Input[]Data of the group that’s related to the party relationship group being created.Optional58.0

Response Body for POST 

Group Definition