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>06254724-2d48-4b4f-8194-de32dd0aa49a</ID>
  <SiteID>ed19ffbb-11af-4766-9561-9305b7f7a685</SiteID>
  <ParentID>690f60fa-bfc4-4137-aa05-64bc9b37ea08</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": "06254724-2d48-4b4f-8194-de32dd0aa49a",
  "SiteID": "ed19ffbb-11af-4766-9561-9305b7f7a685",
  "ParentID": "690f60fa-bfc4-4137-aa05-64bc9b37ea08",
  "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>2abc4a47-7bfa-478f-9ea9-108bd57d0ba5</ID>
  <SiteID>28881862-417b-4b17-a0e1-4e2faef67774</SiteID>
  <ParentID>95d30f88-f204-4bf3-add6-f682ff0b2211</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-06-20T16:40:12.7451734+00:00</Created>
  <CreatedBy>c980fa5a-afcf-46da-9f8f-28d6d4ae388a</CreatedBy>
  <Updated>2025-06-20T16:40:12.7451734+00:00</Updated>
  <UpdatedBy>87133a96-3729-4bac-b2af-8e70b4efd2cb</UpdatedBy>
  <LastComment>sample string 7</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-06-20T16:40:12.7451734Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>eb25e72e-c0fb-48fa-8770-2871f0122ce7</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": "2abc4a47-7bfa-478f-9ea9-108bd57d0ba5",
  "SiteID": "28881862-417b-4b17-a0e1-4e2faef67774",
  "ParentID": "95d30f88-f204-4bf3-add6-f682ff0b2211",
  "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-06-20T16:40:12.7451734+00:00",
  "CreatedBy": "c980fa5a-afcf-46da-9f8f-28d6d4ae388a",
  "Updated": "2025-06-20T16:40:12.7451734+00:00",
  "UpdatedBy": "87133a96-3729-4bac-b2af-8e70b4efd2cb",
  "LastComment": "sample string 7",
  "LastCommentDate": "2025-06-20T16:40:12.7451734+00:00",
  "LastCommentByID": "eb25e72e-c0fb-48fa-8770-2871f0122ce7",
  "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.