---
title: Link Business Objects
slug: neurons-for-itsm/admin-user-help/enu/latest/link-business-objects
createdAt: 2026-07-14T19:16:50.966Z
---

You can link different business objects based on relationships. For example, you can link a journal to an incident.

**Base URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}('\{business object unique key}')/\{business object relationship name}('\{unique key of the related business object}')/$Ref

:::hint{type="info"}
Ensure the business object name is suffixed with an "s".
:::

:::ExpandableHeading
## Link Business Objects - Example

Here is an example to link a journal to an incident.

| `URL`                               | `https://{tenant url}/api/odata/businessobject/incidents`<br />`('87168FCA6F0C46B2B5CDC5226FB7C773')/IncidentContainsJournal`<br />`('4F34DB8563DF450CAE5381CDA9805B21')/$Ref` |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <font color="#ffffff">Method</font> | PATCH                                                                                                                                                                          |
| Header Name                         | Authorization: JTW Token/Session Key/REST API Key                                                                                                                              |
| Status Code                         | 200                                                                                                                                                                            |
| Response Payload                    | `{`<br />`"code": "ISM_2000",`<br />`"description": "Ok",`<br />`"message": [`<br />`"Successfully Created the link"`<br />`],`<br />`"help": ""`<br />`}`                     |
:::

## Unsuccessful Responses

:::ExpandableHeading
## Invalid URL

Scenario: Trying to create a link when the url is invalid.

Invalid URL examples:

`https://{tenant url}/api/odata/businessobject/incident('87168FCA6F0C46B2B5CDC5226FB7C773')/IncidentContainsJournal('4F34DB8563DF450CAE5381CDA9805B21')/$Ref`

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4004                                                   |
| --------------------------------------------- | ----------------------------------------------------------- |
| Description                                   | Not Found                                                   |
| Message                                       | \[<br />"No service for the resource is registered."<br />] |
| <font color="#0C121D">HTTP STATUS CODE</font> | 404                                                         |
:::

:::ExpandableHeading
## Invalid RecID

Scenario: Trying to create a link when the RecID is invalid.

Example:

`https://{tenant url}/api/odata/businessobject/incidentS('87168FCA6F0C46B2B5CDC5226FB7C773')/IncidentContainsJournal('1234')/$Ref`

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4000                                                                                     |
| --------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Description                                   | Invalid Request                                                                               |
| Message                                       | \[<br />"Record '1234' cannot be found in the related business<br />object 'Journal#".<br />] |
| <font color="#0C121D">HTTP STATUS CODE</font> | 400                                                                                           |
:::