POST organizations

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

None.

Body Parameters (Organization)

This object takes all the parameters needed to create a new organization.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Request Formats

application/xml, text/xml

Sample

<Organization xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>0c78becc-4f87-44e4-8ebd-d8e76d543398</ID>
  <SiteID>6918056d-5d04-4b7d-b741-7f2894ff09a8</SiteID>
  <ParentID>085cbd39-e26f-4d00-a74d-fa97b4011fbd</ParentID>
  <Rank>1</Rank>
  <Name>sample string 1</Name>
  <EmotionalGoal>sample string 2</EmotionalGoal>
  <Focus>sample string 3</Focus>
  <Picture>QEA=</Picture>
</Organization>

application/json, text/json

Sample

{
  "ID": "0c78becc-4f87-44e4-8ebd-d8e76d543398",
  "SiteID": "6918056d-5d04-4b7d-b741-7f2894ff09a8",
  "ParentID": "085cbd39-e26f-4d00-a74d-fa97b4011fbd",
  "Rank": 1,
  "Name": "sample string 1",
  "EmotionalGoal": "sample string 2",
  "Focus": "sample string 3",
  "Picture": "QEA="
}

Response Information

Resource Description (Organization)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList

Response Formats

application/xml, text/xml

Sample

<Organization xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>1c9443c9-c898-4506-8db1-98cc5cd39e9d</ID>
  <SiteID>d2671020-d00a-41b2-809e-21b831fae98b</SiteID>
  <ParentID>b9556c1e-549c-4d8b-8e0e-4c3e81cdb432</ParentID>
  <Rank>1</Rank>
  <Name>sample string 1</Name>
  <EmotionalGoal>sample string 2</EmotionalGoal>
  <Focus>sample string 3</Focus>
  <Picture>QEA=</Picture>
  <RowType>1</RowType>
  <RankPath>QEA=</RankPath>
  <RankOrder>sample string 4</RankOrder>
  <DisplayRank>sample string 5</DisplayRank>
  <Level>1</Level>
  <Values>sample string 6</Values>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2025-12-09T17:45:00.0236215+00:00</Created>
  <CreatedBy>b76a5c28-2709-4123-8b8b-c9c5d8a53701</CreatedBy>
  <Updated>2025-12-09T17:45:00.0236215+00:00</Updated>
  <UpdatedBy>f51a46e7-01c0-4848-904b-68cf971464ff</UpdatedBy>
  <LastComment>sample string 7</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-12-09T17:45:00.0236215Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>fa3ed9cf-7fdb-4407-99c4-c7613cd2bd9b</LastCommentByID>
  <LastCommentBy>sample string 8</LastCommentBy>
  <ParentName>sample string 9</ParentName>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
</Organization>

application/json, text/json

Sample

{
  "ID": "1c9443c9-c898-4506-8db1-98cc5cd39e9d",
  "SiteID": "d2671020-d00a-41b2-809e-21b831fae98b",
  "ParentID": "b9556c1e-549c-4d8b-8e0e-4c3e81cdb432",
  "Rank": 1,
  "Name": "sample string 1",
  "EmotionalGoal": "sample string 2",
  "Focus": "sample string 3",
  "Picture": "QEA=",
  "RowType": 1,
  "RankPath": "QEA=",
  "RankOrder": "sample string 4",
  "DisplayRank": "sample string 5",
  "Level": 1,
  "Values": "sample string 6",
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2025-12-09T17:45:00.0236215+00:00",
  "CreatedBy": "b76a5c28-2709-4123-8b8b-c9c5d8a53701",
  "Updated": "2025-12-09T17:45:00.0236215+00:00",
  "UpdatedBy": "f51a46e7-01c0-4848-904b-68cf971464ff",
  "LastComment": "sample string 7",
  "LastCommentDate": "2025-12-09T17:45:00.0236215+00:00",
  "LastCommentByID": "fa3ed9cf-7fdb-4407-99c4-c7613cd2bd9b",
  "LastCommentBy": "sample string 8",
  "ParentName": "sample string 9",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true
}

Name	Description
ID `globally unique identifier` Required on Update ID of the given organization/department.	`globally unique identifier` Required on Update ID of the given organization/department.
SiteID `globally unique identifier` ID of the site for the given organization/department.	`globally unique identifier` ID of the site for the given organization/department.
ParentID `globally unique identifier` ID of the parent for the given organization/department. This will be a site ID for a given organization or an organization ID for a given department.	`globally unique identifier` ID of the parent for the given organization/department. This will be a site ID for a given organization or an organization ID for a given department.
Rank `integer` Required Rank of the given organization/department.	`integer` Required Rank of the given organization/department.
Name `string` Required Name of the given organization/department. (Max length 100 characters)	`string` Required Name of the given organization/department. (Max length 100 characters)
EmotionalGoal `string` Emotional Goal of the given organization/department. (Max length 1000 characters)	`string` Emotional Goal of the given organization/department. (Max length 1000 characters)
Focus `string` Focus of the given organization/department.	`string` Focus of the given organization/department.
Picture `Collection of byte` Picture of the given organization/department.	`Collection of byte` Picture of the given organization/department.
RowType `integer` ReadOnly RowType of the given organization(4) or department(56).	`integer` ReadOnly RowType of the given organization(4) or department(56).
RankPath `Collection of byte` ReadOnly Current rank of the given Organization/Department in a byte array.	`Collection of byte` ReadOnly Current rank of the given Organization/Department in a byte array.
RankOrder `string` ReadOnly Rank in string format, (0001.0001.0001) for the given organization/department.	`string` ReadOnly Rank in string format, (0001.0001.0001) for the given organization/department.
DisplayRank `string` ReadOnly Rank that is actually displayed.	`string` ReadOnly Rank that is actually displayed.
Level `integer` ReadOnly Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3	`integer` ReadOnly Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3
Values `string` ReadOnly Value of the given organization/department.	`string` ReadOnly Value of the given organization/department.
Deleted `boolean` ReadOnly Deleted status of the given organization/department.	`boolean` ReadOnly Deleted status of the given organization/department.
DeletedByRef `boolean` ReadOnly Deleted by reference status of the given organization/department.	`boolean` ReadOnly Deleted by reference status of the given organization/department.
Created `date` ReadOnly Date the given organization/department was created.	`date` ReadOnly Date the given organization/department was created.
CreatedBy `globally unique identifier` ReadOnly ID of the individual who created the given organization/department.	`globally unique identifier` ReadOnly ID of the individual who created the given organization/department.
Updated `date` ReadOnly The date that the given organization/department was last updated.	`date` ReadOnly The date that the given organization/department was last updated.
UpdatedBy `globally unique identifier` ReadOnly The ID of the individual that updated the given organization/department.	`globally unique identifier` ReadOnly The ID of the individual that updated the given organization/department.
LastComment `string` ReadOnly Body of the most recent comment.	`string` ReadOnly Body of the most recent comment.
LastCommentDate `date` ReadOnly Date the most recent comment was posted.	`date` ReadOnly Date the most recent comment was posted.
LastCommentByID `globally unique identifier` ReadOnly ID of the user who posted the most recent comment.	`globally unique identifier` ReadOnly ID of the user who posted the most recent comment.
LastCommentBy `string` ReadOnly Name of the user who posted the most recent comment.	`string` ReadOnly Name of the user who posted the most recent comment.
ParentName `string` ReadOnly Name of the parent for the given Organization/Department. This will be a site for a given organization or an organization for a given department.	`string` ReadOnly Name of the parent for the given Organization/Department. This will be a site for a given organization or an organization for a given department.
CanRead `boolean` ReadOnly Read security setting for the object based on the current logged in user.	`boolean` ReadOnly Read security setting for the object based on the current logged in user.
CanUpdate `boolean` ReadOnly Update security setting for the object based on the current logged in user.	`boolean` ReadOnly Update security setting for the object based on the current logged in user.
CanDelete `boolean` ReadOnly Delete security setting for the object based on the current logged in user.	`boolean` ReadOnly Delete security setting for the object based on the current logged in user.
CanDelegate `boolean` ReadOnly Delegate security setting for the object based on the current logged in user.	`boolean` ReadOnly Delegate security setting for the object based on the current logged in user.