---
title: Create a Business Object
slug: neurons-for-itsm/admin-user-help/enu/latest/create-a-business-object
createdAt: 2026-07-14T19:16:23.624Z
---
You can create business objects available out-of-the-box, such as a Change, Problem, Incident, or any custom defined business object of your choice.
**Base URL:**
`https://{tenant url}/api/odata/businessobject/{business object name}`
:::hint{type="info"}
Ensure the business object name is suffixed with an "s".
:::
::::ExpandableHeading
## Create a Business Object - Example
Here is an example to create a change business object.
:::hint{type="info"}
You can create any other business object of your choice by following the example but ensure you provide the appropriate business object name suffixed with "s" in the businessobject place holder in the **URL** and enter relevant details in the **Request Payload**.
:::
| URL | `https://{tenant url}/api/odata/businessobject/changes` |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Method | POST |
| Header Name | Authorization: JWT Token/Session Key/REST API Key |
| Request Payload | "Category": "Computer",
"CreatedBy":"Admin",
"RequestorLink\_RecID":"FB884D18F7B746A0992880F2DFFE749C",
"Description" : "test",
"Owner": "BHeath",
"OwnerTeam":"Accounting",
"Subject":"test",
"OwnerTeam\_Valid":"8D796372096546AC9008C0EDAB18EE5F",
"Owner\_Valid":"147098AD139247F6B177042064C5E39C",
"Status":"Logged",
"TypeOfChange": "Minor" |
| tatus Code | 201 |
| Response Payload | "@odata.context": "http\://\{tenant url}/api/odata/change/$metadata#changes/$entity",
"AcceptanceDueDate": "0001-01-01T00:00:00Z",
"AcceptTimeout": "0001-01-01T00:00:00Z",
"BackoutPlanAttached": false,
"BallotCount": null,
"BusinessFunction\_Valid": null,
"BusinessFunction": null,
"Category\_Valid": "18FCF302685C41A9AB4D4E6C52123A56",
"Category": "Computer",
"ChangeNumber": 0,
"ClosedBy": null,
"ClosedCode\_Valid": null,
"ClosedCode": null,
"ClosedDateTime": "0001-01-01T00:00:00Z",
"CompletedBy": null,
"CreatedBy": "Admin",
"CreatedByRecID": "FB884D18F7B746A0992880F2DFFE749C",
"CreatedDateTime": "2018-08-07T06:06:52+05:30",
"DirectCost": 0,
"Emergency": false,
"EstimatedCost": 0,
"ExternalCalendarLinkID": null,
"ExternalTaskLinkID": null,
"FinalState": "False",
"Impact\_Valid": null,
"Impact": null,
"LastModBy": "Admin",
"LastModDateTime": "2018-08-07T11:36:52+05:30",
"Owner\_Valid": "147098AD139247F6B177042064C5E39C",
"Owner": "BHeath",
"OwnerTeam\_Valid": "8D796372096546AC9008C0EDAB18EE5F",
"OwnerTeam": "Accounting",
"OwnerType": null,
"ParentLink\_Category": null,
"ParentLink\_RecID": null,
"ParentLink": null,
"Priority": null,
"Reason\_Valid": null,
"Reason": null,
"RecId": "67D90C9B57334F84A7B0EEEEA3FBC743",
"RequestedBy": "Administrator Admin",
"RequestorLink\_Category": "Employee",
"RequestorLink\_RecID": "FB884D18F7B746A0992880F2DFFE749C",
"RequestorLink": "FB884D18F7B746A0992880F2DFFE749C",
"ScheduledEndDate": "0001-01-01T00:00:00Z",
"ScheduledStartDate": "0001-01-01T00:00:00Z",
"Service\_Valid": null,
"Service": null,
"Status\_Valid": "DED387BDB5D843B089246E22563F6446",
"Status": "Logged",
Subject": "test",
"TargetBreach": false,
"TargetDate": "0001-01-01T00:00:00Z",
"TypeOfChange\_Valid": "B3DB5AAC881E4D88A97890232C867B4D",
"TypeOfChange": "Minor",
"Urgency\_Valid": null,
"Urgency": null,
"VoteCount": null,
"VoteExpirationDateTime": "0001-01-01T00:00:00Z",
"VoteTimeout": "0001-01-01T00:00:00Z",
"TempChangeTaskSubject": null,
"ChangesTested": false,
"DetailScreenName": null,
"LinkTargetComputer": false,
"MsgPreExistInventoryItem": null,
"IsScheduledStartDateFilled": false,
"RequestorEmail": "admin\@saasitdemo.com",
"CABMeetingTime": "0001-01-01T00:00:00Z",
"CalculatedRiskQuestions": false,
"CatalogName": null,
"CMApprovedBy": null,
"CMApprovedDateTime": "0001-01-01T00:00:00Z",
"IsCIAdded": "0001-01-01T00:00:00Z",
"IsStandardChange": false,
"Justification\_Valid": null,
"Justification": null,
"NoOfCILinked": 0,
"NoOfTasks": 0,
"NoOfTasksCompleted": 0,
"OwnerEmail": "BHeath\@saasitdemo.com",
"ReleaseCIJscriptHolder": null,
"RequestorFullName": "Administrator Admin",
"RiskSum": 0,
"SetChangeWindowJscriptHolder": null,
"Sponsor\_Valid": null,
"Sponsor": null,
"RiskLevel\_Valid": null,"RiskLevel": null,"RiskCatalogLink\_Category": null,
"RiskCatalogLink\_RecID": null,
"RiskCatalogLink": null,
"ReleaseLink\_Category": null,
"ReleaseLink\_RecID": null,
"ReleaseLink": null,
"TriggerChangesToCI": "0001-01-01T00:00:00Z",
"RequesterLocation": "USA",
"RequesterPhone": "7195551254",
"MCVoteExpirationDateTime": "0001-01-01T00:00:00Z",
"ECABVoteExpirationDateTime": "0001-01-01T00:00:00Z",
"CABVoteExpirationDateTime": "0001-01-01T00:00:00Z",
"SubmissionDeadLineDateTime": "0001-01-01T00:00:00Z",
"CABReviewDate": "0001-01-01T00:00:00Z",
"RiskTotalScore": null,
"ReadOnly": false,
"OwnerFullName": "Bo R Heath",
"Cost": 0,
"TotalTimeSpent": 0,
"IsUnRead": false
} |
::::
## Unsuccessful Responses
:::ExpandableHeading
## Empty Request Body
Scenario: Trying to create a business object with empty request body.
Header Name:
**Authorization: Sessionkey**
| Code | ISM\_4000 |
| --------------------------------------------- | ---------------------------------------------- |
| Description | Invalid Request Payload |
| Message | \{
"Message body cannot be empty."
} |
| HTTP STATUS CODE | **400** |
:::
:::ExpandableHeading
## Invalid Request Body
Scenario: Trying to create a business object invalid request body.
Header Name:
**Authorization: Sessionkey**
| Code | ISM\_4000 |
| --------------------------------------------- | ------------------------------------------ |
| Description | Invalid Request Payload |
| Message | \[
"Invalid Business Object."
], |
| HTTP STATUS CODE | **400** |
:::
:::ExpandableHeading
## Missing Required Fields
Scenario: Trying to create a business object with missing mandatory fields.
Header Name:
**Authorization: Sessionkey**
| Code | ISM\_4000 |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Description | Invalid Request Payload |
| Message | \[
"Mandatory field "Category" value must be provided.",
"Mandatory field "Description" value must be provided.",
"Mandatory field "Status" value must be provided."
] |
| HTTP STATUS CODE | **400** |
:::
:::ExpandableHeading
## Invalid Response
Scenario: When trying to create an incident or update an incident, the application fails to save and give a proper response from our API.
Header Name:
**Authorization: Sessionkey**
| | |
| -------------- | - |
| | |
| | |
| TP STATUS CODE | |
:::