Insert a new group

Insert a new group

post

Insert a new group into database

Authorizations

bearerAuth

AuthorizationstringRequired

Use Common JWT

Header parameters

X-Symphony-Hoststring · min: 1Required

headers to indentify the originator

Example: localhost.symphony.com

Body

application/json

and

Responses

201

Successful response. Returns the group just created with the new added member

application/json

400

Returned if missing required parameters, Trying to add a member which is already existing within the group list of members, or the requested user member is already a part of company group in case of a company group type

application/json

401

Returned if wrong or missing JWT token

application/json

403

Returned if JWT token missing the required entitlement

application/json

429

Returned if the backend is overloaded

application/json

452

Returned if there is a violation in info barrier rules. This error is not relevant in case of a Company group

application/json

post

/v1/groups

HTTPcURLJavaScriptPython

POST /profile-manager/v1/groups HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
X-Symphony-Host: localhost.symphony.com
Content-Type: application/json
Accept: */*
Content-Length: 828

{
  "type": "SDL",
  "ownerType": "TENANT",
  "ownerId": 100,
  "name": "Test Group",
  "subType": "COMMUNITY",
  "referrer": "text",
  "members": [],
  "profile": {
    "displayName": "Test Group",
    "companyName": "Acme Corporation",
    "email": "[email protected]",
    "mobile": "[phone]",
    "jobTitle": "text",
    "jobRole": "Director",
    "jobDepartment": "text",
    "jobDivision": "text",
    "jobPhone": "text",
    "jobCity": "text",
    "industryOfInterest": [
      "Services"
    ],
    "assetClassesOfInterest": [
      "Equities"
    ],
    "marketCoverage": [
      "EMEA"
    ],
    "responsibility": [
      "Escalation"
    ],
    "function": [
      "Collateral"
    ],
    "instrument": [
      "Equities"
    ]
  },
  "visibilityRestriction": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  },
  "implicitConnection": {
    "connectedTenantsList": [
      100
    ],
    "connectedUsersList": [
      12345678900000
    ]
  },
  "interactionTransfer": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  }
}

{
  "type": "SDL",
  "ownerType": "TENANT",
  "ownerId": 100,
  "name": "Test Group",
  "id": "text",
  "createdDate": "2026-03-10T00:05:07.803Z",
  "createdBy": "text",
  "updatedDate": "2026-03-10T00:05:07.803Z",
  "updatedBy": "text",
  "status": "ACTIVE",
  "eTag": "e3a52e72-0854-4401-8c24-e0b17c0ca304",
  "members": [
    {
      "memberTenant": 100,
      "memberId": 12345678900000
    },
    {
      "addedDate": "2026-03-10T00:05:07.803Z"
    }
  ],
  "profile": {
    "displayName": "Test Group",
    "companyName": "Acme Corporation",
    "email": "[email protected]",
    "mobile": "[phone]",
    "jobTitle": "text",
    "jobRole": "Director",
    "jobDepartment": "text",
    "jobDivision": "text",
    "jobPhone": "text",
    "jobCity": "text",
    "industryOfInterest": [
      "Services"
    ],
    "assetClassesOfInterest": [
      "Equities"
    ],
    "marketCoverage": [
      "EMEA"
    ],
    "responsibility": [
      "Escalation"
    ],
    "function": [
      "Collateral"
    ],
    "instrument": [
      "Equities"
    ],
    "id": "text",
    "avatars": []
  },
  "visibilityRestriction": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  },
  "implicitConnection": {
    "connectedTenantsList": [
      100
    ],
    "connectedUsersList": [
      12345678900000
    ]
  },
  "interactionTransfer": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  }
}