---
title: Party Management Open API
description: The Party Management Open API provides endpoints for managing parties with a relationship to the enterprise, like a consumer, account, or contact. Use this API to create, update, and retrieve data from the Consumer \[csm\_consumer\], Account \[customer\_account\], and Contact \[customer\_contact\] tables.Inactivates a specified record from the Consumer \[csm\_consumer\] and Contact \[customer\_contact\] tables.Retrieves a list of all individual \(party\) records with a relationship to the enterprise. You can filter results by specific fields or IDs.Retrieves a specified record from the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] tables. You can filter results by specific fields.Retrieves a specified record from the Account \[customer\_account\] tables. You can filter results by specific fields or IDs.Retrieves organization-level party records from the Company \[core\_company\] and Account \[customer\_account\] tables. You can filter results by specific fields or IDs.Updates an existing individual party record in the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] table without replacing the entire resource.Updates an existing individual party record in the Account \[customer\_account\] tables without replacing the entire resource.Creates a new individual party management record in the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] tables.Creates a new party organization record in the Account \[customer\_account\] tables. You can also create and associate Contact and Location records inline during organization creation, eliminating the need for separate POST operations.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/api-reference/rest-apis/tmf-party-management-open-api.html
release: australia
product: REST APIs
classification: rest-apis
topic_type: concept
last_updated: "2026-03-12"
reading_time_minutes: 76
breadcrumb: [REST API reference, API reference, API implementation and reference]
---

# Party Management Open API

The Party Management Open API provides endpoints for managing parties with a relationship to the enterprise, like a consumer, account, or contact. Use this API to create, update, and retrieve data from the Consumer \[csm\_consumer\], Account \[customer\_account\], and Contact \[customer\_contact\] tables.

The Party Management Open API is a ServiceNow® implementation of the TM Forum Party Management API REST specification. This implementation is based on the [TMF632 Party Management API Conformance Profile v5.0.0 – TM Forum](https://www.tmforum.org/resources/reference/tmf632b-party-management-api-conformance-profile-v5-0-0/), June 2025. The Party Management Open API is conformance certified by TM Forum.

This API is provided within the sn\_tmf\_api namespace. The calling user must have the sn\_tmf\_api.party\_integrator role. The Customer Service Base Entities \(com.snc.cs\_base\) plugin is required, particularly for all GET operations.

This API can be extended to make customizations around required parameters, request body validation, additional REST operations, and field mappings. Sensitive fields like phone numbers may require special ACL permissions for update or retrieval.

## v2: CTK Compliance and Structural Changes

The Party Management Open API has been updated to align with TMF 632 CTK \(Core Transaction Kernel\) compliance standards. These changes improve interoperability with external telecommunications systems and clarify the structure of party and relationship data.

Key changes with v2:

1.  Removal of PartyOrPartyRole Object: In previous versions, a `PartyOrPartyRole` object at the root level was used to determine whether a request would create an Account, Consumer, or Contact. This object is no longer supported and has been removed. Use the `@type` field instead.
2.  Introduction of @type at Root Level: The `@type` field is now mandatory at the root level of all requests to POST endpoints. This field explicitly declares the type of party object being created:
    -   `@type: "Account"`: Creates or updates an Account record.
    -   `@type: "Consumer"`: Creates or updates a Consumer record.
    -   `@type: "Contact"`: Creates or updates a Contact record.

The v1 API endpoints continue to support the legacy `PartyOrPartyRole` structure. For new integrations or when upgrading existing integrations, use the v2 endpoints with the updated `@type` structure. Both versions are available during the transition period; however, v1 is deprecated and will be sunset in a future release.

## Migration Guide

If you are upgrading from a previous version using `PartyOrPartyRole`:

1.  **Remove** any `PartyOrPartyRole` object from your request payload
2.  **Add** the `@type` field at the root level with the appropriate value \(`Account`, `Consumer`, or `Contact`\)
3.  **Update** the `relatedParty` object to include the mandatory `@type` field \(set to `"User"` for Consumer creation\)
4.  **Retain** the `role` field in `relatedParty` with value `"User"`

**Parent Topic:**[REST API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-apis/api-rest.md)

## Party Management – DELETE /api/sn\_tmf\_api/v1/party/individual/\{id\}

Inactivates a specified record from the Consumer \[csm\_consumer\] and Contact \[customer\_contact\] tables.

### URL format

Versioned URL: `/api/sn_tmf_api/{api_version}/party/individual/{id}`

Default URL: `/api/sn_tmf_api/v1/party/individual/{id}`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id or external\_id of the Consumer or Contact record to set to an inactive state.Table: Consumer \[csm\_consumer\] and Contact \[customer\_contact\].

Data type: String

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|
|400|Bad Request. A bad request type or malformed request was detected.|

### Response body parameters \(JSON or XML\)

|Name|Description|
|----|-----------|
|None||

### cURL request

The following example deletes the given record.

```
curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/individual/dca96eaa11f43110f877366201dea6c1" \
--request DELETE \
--header "Accept:application/json" \
--user 'user':'password' \
```

Doesn't return a response body. Reference status codes for a success or failure indicator.

## Party Management – GET /api/sn\_tmf\_api/v1/party/individual

Retrieves a list of all individual \(party\) records with a relationship to the enterprise. You can filter results by specific fields or IDs.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/individual`

Default URL: `/api/sn_tmf_api/v1/party/individual`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table><table class="rest_api_query_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

fields

</td><td>

List of fields to return in the response. Invalid fields are ignored.Valid fields:

-   @type
-   familyName
-   gender
-   givenName
-   href
-   id
-   middleName
-   name
-   nationality
-   status
-   title

Data type: String

Default: Returns all fields.

</td></tr><tr><td>

id

</td><td>

Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String

</td></tr><tr><td>

limit

</td><td>

Maximum number of records to return. For requests that exceed this number of records, use the **offset** parameter to paginate record retrieval.Data type: Number

Default: 20

Maximum: 100

</td></tr><tr><td>

offset

</td><td>

Starting index at which to begin retrieving records. Use this value to paginate record retrieval.Data type: Number

Default: 0

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table><table class="rest_api_response_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Content-Range

</td><td>

Range of content returned in a paginated call.For example, if offset=2 and limit=3, the value of the Content-Range header is items 3-5.

</td></tr><tr><td>

Content-Type

</td><td>

Data format of the response body. Only supports application/json.

</td></tr><tr><td>

Link

</td><td>

Contains the following links to navigate through query results:

-   first
-   last
-   next
-   previous

</td></tr><tr><td>

X-Total-Count

</td><td>

For paginated queries, this header specifies the total number of records available on the server.

</td></tr></tbody>
</table>### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table><thead><tr><th>

Status code

</th><th>

Description

</th></tr></thead><tbody><tr><td>

200

</td><td>

Request successfully processed. Full resource returned in response \(no pagination\).

</td></tr><tr><td>

206

</td><td>

Partial resource returned in response \(with pagination\).

</td></tr><tr><td>

400

</td><td>

Bad request. Possible reasons:-   Invalid path parameter
-   Invalid URI

</td></tr><tr><td>

404

</td><td>

Record not found. No records matching the query parameters are found in the table.

</td></tr></tbody>
</table>### Response body parameters \(JSON or XML\)

<table id="id_eyq_bh4_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual is in an inactive status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### cURL request

Retrieves a list of all party management records in the instance.

```
curl"http://instance.servicenow.com/api/v1/sn_tmf_api/party/individual" \
--request GET \
--header "Accept:application/json" \
--user 'user:password' 
```

Response body for a Individual Contact party.

```
[
{
   "id": "34d92aaa11f43110f877366201dea67b",
   "externalId": "LOC-SF-HQ-2026",
   "href": "api/sn_tmf_api/party/individual/34d92aaa11f43110f877366201dea67b",
   "name": "carlos.star",
   "givenName": "Carlos",
   "middleName": "",
   "familyName": "Star",
   "gender": "",
   "title": "",
   "partyCharacteristics": [
     {
       "name": "notification",
       "value": "Enable",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "preferredLanguage",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "dateFormat",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "timeFormat",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "timeZone",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "vip",
       "value": false,
       "valueType": "boolean",
       "@type": "BooleanCharacteristic"
     },
     {
       "name": "webServiceAccessOnly",
       "value": false,
       "valueType": "boolean",
       "@type": "BooleanCharacteristic"
     },
     {
       "name": "source",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "eduStatus",
       "value": "Faculty",
       "valueType": "string",
       "@type": "StringCharacteristic"
     }
   ],
   "contactMedium": [
     {
       "preferred": false,
       "mediumType": "email",
       "emailAddress": "carlos.star@example.com",
       "@type": "EmailContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "businessPhone",
       "phoneNumber": "",
       "@type": "BusinessPhoneContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "homePhone",
       "phoneNumber": "",
       "@type": "HomePhoneContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "mobilePhone",
       "phoneNumber": "",
       "@type": "MobilePhoneContactMedium"
     }
   ],
   "externalReference": [],
   "relatedParty": [
     {
       "@type": "Company",
       "role": "Company"
     },
     {
       "role": "Department"
     }
   ],
   "status": "Active",
   "@type": "Individual"
 }
]
```

Response body for a Individual Consumer party.

```
[
{
   "id": "168bfc6953a46210132bddeeff7b129f",
   "href": "api/sn_tmf_api/party/individual/168bfc6953a46210132bddeeff7b129f",
   "givenName": "yyyg",
   "middleName": "hhh",
   "familyName": "bhhhbjhh",
   "gender": "",
   "nationality": "",
   "title": "",
   "partyCharacteristics": [
     {
       "name": "notes",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "user",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "notification",
       "value": "Enable",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "preferredLanguage",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "dateFormat",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "timeFormat",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "timeZone",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     }
   ],
   "contactMedium": [
     {
       "preferred": false,
       "mediumType": "businessPhone",
       "phoneNumber": "",
       "@type": "BusinessPhoneContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "homePhone",
       "phoneNumber": "",
       "@type": "HomePhoneContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "mobilePhone",
       "phoneNumber": "",
       "@type": "MobilePhoneContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "fax",
       "phoneNumber": "",
       "@type": "FaxContactMedium"
     },
     {
       "preferred": false,
       "mediumType": "postalAddress",
       "@type": "GeographicalAddressContactMedium",
       "city": "ygyg",
       "locationId": "a39bfc6953a46210132bddeeff7b12b7",
       "country": "",
       "postCode": "hh",
       "stateOrProvince": "gyg",
       "street1": "hgg",
       "street2": ""
     }
   ],
   "externalReference": [],
   "relatedParty": [
     {
       "@type": "User",
       "role": "User"
     }
   ],
   "status": "Active",
   "@type": "User"
 }
]
```

## Party Management - GET /api/sn\_tmf\_api/v1/party/individual/\{id\}

Retrieves a specified record from the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] tables. You can filter results by specific fields.

### URL format

Versioned URL: `/api/sn_tmf_api/{api_version}/party/individual`

Default URL: `/api/sn_tmf_api/v1/party/individual`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id or external\_id of the consumer or contact record to retrieve.Table: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr></tbody>
</table><table class="rest_api_query_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

fields

</td><td>

List of fields to return in the response. Invalid fields are ignored.Valid fields:

-   @type
-   familyName
-   gender
-   givenName
-   href
-   id
-   middleName
-   name
-   nationality
-   status
-   title

Data type: String

Default: Returns all fields

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="table_mh2_hc4_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual is in an inactive status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### cURL request

Retrieves a specified record, `12345`, from the table.

```
curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual/12345" \
--request GET \
--header "Accept:application/json" \
--user 'user':'password' \
```

Response body.

```
{
  "id": "12345",
  "externalId": "LOC-SF-HQ-2026",
  "givenName": "JohnTest6",
  "middleName": "A.",
  "familyName": "Doe",
  "gender": "male",
  "nationality": "American",
  "title": "Mr",
  "contactMedium": [
    {
      "preferred": true,
      "mediumType": "email",
      "emailAddress": "john.doe18723@example.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "mobilePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "businessPhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred":false,
      "mediumType":"faxPhone",
      "phoneNumber":"123456789",
      "@type":"FaxContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "homePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "postalAddress",
      "@type": "GeographicAddressContactMedium",
      "locationId":"25ab9e240a0a0bb3009eb9ef8dd0a2c0",
      "city": "Town",
      "country": "USA",
      "postCode": "07960",
      "stateOrProvince": "New Jersey",
      "street1": "1820 Harris Houston Road, Charlotte",
      "street2": "East Tower - 10th Floor"
    },
    {
      "preferred": false,
      "mediumType": "postalAddress",
      "@type": "GeographicAddressContactMedium",
      "locationId":"25aba17a0a0a0bb3007efd809d6e695c",
      "city": "Webster",
      "country": "USA",
      "postCode": "76022",
      "stateOrProvince": "TN",
      "street1": "17077 Texas Avenue, Webster",
      "street2": "East Tower - 11th Floor"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "facebook",
      "id": "http://facebook.com/johndoe"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "notes about the consumer",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "dateFormat",
      "value": "dd-mm-yyyy",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "timeformat",
      "value": "hh.mm.ss (12 hour)",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "notification",
      "value": "Enable",
      "valueType": "string",
      "@type": "string"
    }
  ],
  "relatedParty": [
    {
      "@type": "User",
      "role": "User"
    }
  ],
  "status": "active",
  "@type": "User"
}
```

## Party Management – GET /api/ sn\_tmf\_api/v1/party/organization/\{id\}

Retrieves a specified record from the Account \[customer\_account\] tables. You can filter results by specific fields or IDs.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/organization/{id}`

Default URL: `/api/sn_tmf_api/v1/party/organization/{id}`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the company or account record to retrieve.Table: Account \[customer\_account\] or Company \[csm\_company\]

Data type: String

</td></tr></tbody>
</table><table class="rest_api_query_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

fields

</td><td>

List of fields to return in the response. Invalid fields are ignored.Valid fields:

-   @type
-   href
-   id
-   legalName
-   name
-   status
-   tradingName

Data type: String

Default: Returns all fields

</td></tr><tr><td>

id

</td><td>

Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String

</td></tr><tr><td>

limit

</td><td>

Maximum number of records to return. For requests that exceed this number of records, use the **offset** parameter to paginate record retrieval.Data type: Number

Default: 20

Maximum: 100

</td></tr><tr><td>

offset

</td><td>

Starting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks.Data type: Number

Default: 0

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="table_edn_qnn_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Possible values:

-   businessPhone
-   email
-   faxPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

createdDate

</td><td>

Timestamp when the organization record was created \(ISO 8601 format\). Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

lastModifiedDate

</td><td>

Timestamp when the organization record was last modified \(ISO 8601 format\).Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### cURL request

The following GET call returns fields for the specified party management organization record with sys\_id, 12345.

```
curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization/12345" \
--request GET \
--header "Accept:application/json" \
--user 'user':'password' \
```

Response body.

```
{
   "id": "2154376",
   "name": "Advances Super Computing",
   "href": "api/sn_tmf_api/party/organization/2154376",
   "externalId": "LOC-SF-HQ-2026",
   "legalName": "Hello",
   "tradingName": "World",
   "contactMedium": [
     {
       "preferred": "false",
       "mediumType": "email",
       "@type": "EmailContactMedium",
       "emailAddress": "user@servicenow.com"
     },
     {
       "preferred": "false",
       "mediumType": "phone",
       "@type": "PhoneContactMedium",
       "phone": "(555) 555-5555"
     },
     {
       "preferred": "false",
       "mediumType": "faxPhone",
       "@type": "FaxPhoneContactMedium",
       "fax_phone": ""
     }
   ],
   "externalReference": [
     {
       "externalIdentifierType": "Facebook",
       "name": "facebook.com"
     },
     {
       "externalIdentifierType": "Twitter",
       "name": "twitter.com"
     }
   ],
   "partyCharacteristic": [
     {
       "name": "notes",
       "value": "efdxcjkn ",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "registrationCode",
       "value": "23456789",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "accountCode",
       "value": "####30",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "identificationNumber",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "taxId",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "industry",
       "value": "",
       "valueType": "choice",
       "@type": "StringCharacteristic"
     },
     {
       "name": "numEmployees",
       "value": "",
       "valueType": "integer",
       "@type": "IntergerCharacteristic"
     },
     {
       "name": "rankTier",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "publiclyTraded",
       "value": "false",
       "valueType": "boolean",
       "@type": "BooleanCharacteristic"
     },
     {
       "name": "stockSymbol",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "stockPrice",
       "value": "",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "vendorType",
       "value": "Services, Applications",
       "valueType": "list",
       "@type": "StringArrayCharacteristic"
     },
     {
       "name": "marketCap",
       "value": "0",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "profits",
       "value": "0",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "revenuePerYear",
       "value": "0",
       "valueType": "string",
       "@type": "StringCharacteristic"
     },
     {
       "name": "website",
       "value": "sdfgh.com",
       "valueType": "string",
       "@type": "StringCharacteristic"
     }
   ],
   "relatedParty": [
     {
       "type": "User",
       "role": "primary"
     },
     {
       "type": "User",
       "role": "other"
     },
     {
       "type": "User",
       "role": "other"
     }
   ],
   "organizationChildRelationship": [
     {
       "relationshipType": "partner_account",
       "organization": {
         "id": "9e2fd2ee11b43110f877366201dea674",
         "name": "Startech svcs",
         "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674",
         "@type": "Organization"
       }
     },
     {
       "relationshipType": "New type",
       "organization": {
         "id": "9e2fd2ee11b43110f877366201dea674",
         "name": "Startech svcs",
         "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674",
         "@type": "Organization"
       }
     },
     {
       "relationshipType": "child",
       "organization": {
         "id": "9e2fd2ee11b43110f877366201dea674",
         "name": "Startech svcs",
         "href": "api/sn_tmf_api/party/organization/null",
         "@type": "Organization"
       }
     }
   ],
   "organizationParentRelationship": {
     "relationshipType": "parent",
     "organization": {
       "id": "ffc68911c35420105252716b7d40dd55",
       "name": "Funco Intl",
       "href": "undefinedffc68911c35420105252716b7d40dd55",
       "@type": "Organization"
     }
   },
   "status": "inActive",
   "@type": "User"
 }
```

## Party Management - GET /api/sn\_tmf\_api/v1/party/organization

Retrieves organization-level party records from the Company \[core\_company\] and Account \[customer\_account\] tables. You can filter results by specific fields or IDs.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/organization`

Default URL: `/api/sn_tmf_api/v1/party/organization`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table><table class="rest_api_query_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

fields

</td><td>

List of fields to return in the response. Invalid fields are ignored.Valid fields:

-   @type
-   href
-   id
-   legalName
-   name
-   status
-   tradingName

Data type: String

Default: Returns all fields

</td></tr><tr><td>

id

</td><td>

Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String

</td></tr><tr><td>

limit

</td><td>

Maximum number of records to return. For requests that exceed this number of records, use the **offset** parameter to paginate record retrieval.Data type: Number

Default: 20

Maximum: 100

</td></tr><tr><td>

offset

</td><td>

Starting index at which to begin retrieving records. Use this value to paginate record retrieval. This functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks.Data type: Number

Default: 0

</td></tr></tbody>
</table><table id="id_avm_mj4_3hc" class="rest_api_request_body"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   `BusinessPhoneContactMedium`: Business phone number
-   `EmailContactMedium`: Email address
-   `FaxPhoneContactMedium`: Fax number
-   `GeographicAddressContactMedium`: Physical address: street, city, state, postal code
-   `HomePhoneContactMedium`: Home phone number
-   `MobilePhoneContactMedium`: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is in a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this parameter defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual isn't in an active status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="table_edn_qnn_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Possible values:

-   businessPhone
-   email
-   faxPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

createdDate

</td><td>

Timestamp when the organization record was created \(ISO 8601 format\). Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

lastModifiedDate

</td><td>

Timestamp when the organization record was last modified \(ISO 8601 format\).Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### cURL request

This returns all organization records related to the enterprise.

```
curl"http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization" \
--request GET \
--header "Accept:application/json" \
--user 'user':'password'
```

Response body.

```
[
  {
    "id": "0bd6717c184da610f87765359bc696d3",
    "name": "SERVICENOW 144",
    "href": "api/sn_tmf_api/party/organization0bd6717c184da610f87765359bc696d3",
    "externalId": "LOC-SF-HQ-2026",
    "legalName": "",
    "tradingName": "",
    "contactMedium": [
      {
        "preferred": "false",
        "mediumType": "email",
        "@type": "EmailContactMedium",
        "emailAddress": "user@email.com"
      },
      {
        "preferred": "false",
        "mediumType": "phone",
        "@type": "PhoneContactMedium",
        "phone": "+1-555-555-5555"
      },
      {
        "preferred": "false",
        "mediumType": "faxPhone",
        "@type": "FaxPhoneContactMedium",
        "fax_phone": ""
      }
    ],
    "externalReference": [
      {
        "externalIdentifierType": "Instagram",
        "name": ""
      }
    ],
    "partyCharacteristic": [
      {
        "name": "notes",
        "value": "Testing for update the notes",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "registrationCode",
        "value": "111122112211",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "accountCode",
        "value": "accountcode1",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "identificationNumber",
        "value": "",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "taxId",
        "value": "CTNUM1000123",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "industry",
        "value": "technology_services",
        "valueType": "choice",
        "@type": "StringCharacteristic"
      },
      {
        "name": "numEmployees",
        "value": "",
        "valueType": "integer",
        "@type": "IntergerCharacteristic"
      },
      {
        "name": "rankTier",
        "value": "rankTier",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "publiclyTraded",
        "value": "false",
        "valueType": "boolean",
        "@type": "BooleanCharacteristic"
      },
      {
        "name": "stockSymbol",
        "value": "Market",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "stockPrice",
        "value": "1000",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "vendorType",
        "value": "Hardware",
        "valueType": "list",
        "@type": "StringArrayCharacteristic"
      },
      {
        "name": "marketCap",
        "value": "0",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "profits",
        "value": "0",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "revenuePerYear",
        "value": "0",
        "valueType": "string",
        "@type": "StringCharacteristic"
      },
      {
        "name": "website",
        "value": "",
        "valueType": "string",
        "@type": "StringCharacteristic"
      }
    ],
    "relatedParty": [],
    "organizationChildRelationship": [
      {
        "relationshipType": "Partner Account",
        "organization": {
          "id": "396b47201841a610f87765359bc696cf",
          "name": "child",
          "href": "api/sn_tmf_api/party/organization396b47201841a610f87765359bc696cf",
          "@type": "Organization"
        }
      }
    ],
    "organizationParentRelationship": {
      "relationshipType": "parent",
      "organization": {
        "id": "9e2fd2ee11b43110f877366201dea674",
        "name": "Startech svcs",
        "href": "api/sn_tmf_api/party/organization9e2fd2ee11b43110f877366201dea674",
        "@type": "Organization"
      }
    },
    "@type": "User"
  }
]
```

## Party Management – PATCH /api/sn\_tmf\_api/v1/party/individual/\{id\}

Updates an existing individual party record in the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] table without replacing the entire resource.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/individual`

Default URL: `/api/sn_tmf_api/v1/party/individual`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the consumer or contact.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

<table id="id_zhv_km4_3hc" class="rest_api_request_body"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   `BusinessPhoneContactMedium`: Business phone number
-   `EmailContactMedium`: Email address
-   `FaxPhoneContactMedium`: Fax number
-   `GeographicAddressContactMedium`: Physical address: street, city, state, postal code
-   `HomePhoneContactMedium`: Home phone number
-   `MobilePhoneContactMedium`: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is in a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this parameter defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual isn't in an active status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="id_t1b_mm4_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual is in an inactive status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### cURL request

Updates an existing individual party record with sys\_id, 12345, in the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] table without replacing the entire resource.

```
curl "http://localhost:8080/api/sn_tmf_api/v1/party/Individual/12345" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user 'user':'password'
--data "{
  \"name\": \"John.Doe\",
  \"givenName\": \"John\",
  \"middleName\": \"A.\",
  \"familyName\": \"Doe\",
  \"gender\": \"male\",
  \"nationality\": \"American\",
  \"title\": \"Mr\",
  \"contactMedium\": [
    {
      \"preferred\": true,
      \"mediumType\": \"email\",
      \"emailAddress\": \"john.doe@gmail.com\",
      \"@type\": \"EmailContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"businessPhone\",
      \"phoneNumber\": \"+1-202-555-0188\",
      \"@type\": \"PhoneContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"homePhone\",
      \"phoneNumber\": \"+1-202-555-0198\",
      \"@type\": \"HomePhoneContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"postalAddress\",
      \"@type\": \"GeographicAddressContactMedium\",
      \"locationId\":\"92656927259338967\",
      \"city\": \"Morristown\",
      \"country\": \"USA\",
      \"postCode\": \"07960\",
      \"stateOrProvince\": \"New Jersey\",
      \"street1\": \"240 Headquarters Plazza\", 
      \"street2\": \"East Tower - 10th Floor\"
    }
  ],
  \"partyCharacteristic\": [
    {
        \"name\": \"notification\",
        \"value\": \"enable\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"dateFormat\",
        \"value\": \"MM/DD/YYYY\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"timeFormat\",
        \"value\": \"12-hour\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"timeZone\",
        \"value\": \"EST\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"vip\",
        \"value\": true,
        \"valueType\": \"boolean\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"webServiceAccessOnly\",
        \"value\": false,
        \"valueType\": \"boolean\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"source\",
        \"value\": \"Third-party system\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    },
    {
        \"name\": \"eduStatus\",
        \"value\": \"Graduated\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
    }
  ],
  \"relatedParty\": [
    {
      \"@type\": \"User\",
      \"role\": \"Company\"
    },
    {
      \"@type\": \"User\"
      \"role\": \"Department\"
    }
  ],
  \"status\": \"active\",
  \"@type\": \"User\"
}" \
```

Response body.

```
{
   "name": "Jane Smith",
  "givenName": "Jane",
  "middleName": "B.",
  "familyName": "Smith",
  "gender": "female",
  "nationality": "American",
  "title": "Ms",
  "contactMedium": [
    {
      "preferred": true,
      "mediumType": "email",
      "emailAddress": "jane.smith@example.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "mobilePhone",
      "phoneNumber": "+1-416-555-1234",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "businessPhone",
      "phoneNumber": "+1-416-555-5678",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "fax",
      "fax": "987654321",
      "@type": "FaxContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "homePhone",
      "phoneNumber": "+1-416-555-4321",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "postalAddress",
      "@type": "GeographicAddressContactMedium",
      "locationId": "03e588a17be062105e0d5494548cb68c",
      "city": "Toronto",
      "country": "Canada",
      "postCode": "M5H 2N2",
      "stateOrProvince": "Ontario",
      "street1": "123 Queen St W",
      "street2": "Suite 1500"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "linkedin",
      "id": "http://linkedin.com/in/janesmith"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "General consumer information.",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "userName",
      "value": "janesmith",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "vip",
      "value": false,
      "valueType": "boolean",
      "@type": "string"
    },
    {
      "name": "source",
      "value": "CRM System",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "dateFormat",
      "value": "yyyy-mm-dd",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "timeformat",
      "value": "HH:mm:ss (24 hour)",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "notification",
      "value": "Disabled",
      "valueType": "string",
      "@type": "string"
    }
  ],
  "relatedParty": [
    {
      "@type": "User",
      "role": "User"
    }
  ],
  "status": "active",
  "@type": "User",
   "warning": [
    "relatedParty[0] is incorrect. User does not exist"
  ]
}
```

## Party Management - PATCH /api/sn\_tmf\_api/v1/party/organization/\{id\}

Updates an existing individual party record in the Account \[customer\_account\] tables without replacing the entire resource.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/organization/{id}`

Default URL: `/api/sn_tmf_api/v1/party/organization/{id}`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

<table id="id_czh_nnj_jhc" class="rest_api_request_body"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.contactType

</td><td>

The type of contact medium. Possible values:

-   `businessPhone`
-   `email`
-   `faxPhone`
-   `homePhone`
-   `mobilePhone`
-   `postalAddress`

Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   `state`
-   `province`

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

organizationChildRelationship

</td><td>

List of child organization relationships, such as subsidiary, partner, or branch organizations. Data type: Array of Objects

```
"organizationChildRelationship": [
  {
    "relationshipType": "String",
    "organization": {Object}
  }
]
```

</td></tr><tr><td>

organizationChildRelationship.organization

</td><td>

Child organization object containing identity and details.Data type: Object

```
"organization": {
        "id": "String",
        "name": "String",
        "@type": "String"
      }
```

</td></tr><tr><td>

organizationChildRelationship.organization.@type

</td><td>

Type of the organization object. Value is always `Organization`.Data type: String

</td></tr><tr><td>

organizationChildRelationship.organization.id

</td><td>

Sys\_id of the child organization record.Table: Account \[customer\_account\] or Organization \[core\_company\]

Data type: String

</td></tr><tr><td>

organizationChildRelationship.organization.name

</td><td>

Display name of the child organization.Data type: String

</td></tr><tr><td>

organizationChildRelationship.relationshipType

</td><td>

Type of relationship between parent and child organization.Data type: String

Accepted values:

-   `partneraccount`
-   `distributor`
-   `subsidiary`
-   `branch`
-   `reseller`

</td></tr><tr><td>

organizationParentRelationship

</td><td>

Parent organization relationship. Data type: Object

```
"organizationParentRelationship": {
  "relationshipType": "String",
  "organization": {Object}
}
```

</td></tr><tr><td>

organizationParentRelationship.organization

</td><td>

Parent organization object containing identity and details.Data type: Object

```
"organization": {
      "id": "String",
      "name": "String",
      "@type": "String"
    }
```

</td></tr><tr><td>

organizationParentRelationship.organization.@type

</td><td>

Type of the organization object. Value is always `Organization`.Data type: String

</td></tr><tr><td>

organizationParentRelationship.organization.id

</td><td>

Sys\_id of the parent organization record. Table: Account \[customer\_account\] or Organization \[core\_company\]

Data type: String

</td></tr><tr><td>

organizationParentRelationship.organization.name

</td><td>

Display name of the parent organization.Data type: String

</td></tr><tr><td>

organizationParentRelationship.relationshipType

</td><td>

Type of relationship between this organization and its parent.Accepted values:

-   `Account`
-   `Company`
-   `HoldingCompany`
-   `ParentAccount`

Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Accepted values:

-   notes
-   customer
-   registrationCode
-   vendorType
-   industry
-   taxId
-   numEmployees
-   rankTier
-   publiclyTraded
-   stockSymbolstockPrice
-   vendor
-   manufacturer
-   marketCap
-   profits
-   revenuePerYear
-   vendorType

**Note:** The **partyCharacteristic.value** attribute accepts the display value of `rankTier` and `industry` choice fields as input. Invalid values will trigger a warning message in the response.

Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="table_edn_qnn_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Possible values:

-   businessPhone
-   email
-   faxPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

createdDate

</td><td>

Timestamp when the organization record was created \(ISO 8601 format\). Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

lastModifiedDate

</td><td>

Timestamp when the organization record was last modified \(ISO 8601 format\).Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### cURL request

This returns specified fields for the party management organization records.

```
curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \
--request PATCH\
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user 'user':'password' \
--data "{
  \"name\": \"SERVICENOW 144\",
  \"legalName\": \"Acme Corp Ltd.\",
  \"tradingName\": \"Acme Inc.\",
  \"contactMedium\": [
    {
      \"preferred\": true,
      \"mediumType\": \"email\",
      \"emailAddress\": \"athammhd@email.com\",
      \"@type\": \"EmailContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"phone\",
      \"phoneNumber\": \"+1-202-555-0198\",
      \"@type\": \"PhoneContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"businessPhone\",
      \"phoneNumber\": \"+1-202-555-0198\",
      \"@type\": \"BusinessPhoneContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"homePhone\",
      \"phoneNumber\": \"+1-202-555-0198\",
      \"@type\": \"HomePhoneContactMedium\"
    },
    {
      \"preferred\": false,
      \"mediumType\": \"postalAddress\",
      \"validFor\": {
        \"startDateTime\": \"2017-03-15T07:49:25.246Z\"
      },
      \"@type\": \"GeographicAddressContactMedium\",
      \"city\": \"chennai\",
      \"country\": \"INDIA\",
      \"postCode\": \"608001\",
      \"stateOrProvince\": \"tamil nadu\",
      \"street1\": \"samcon street\",
      \"street2\": \"adyar,chennai\"
    }
  ],
  \"externalReference\": [
    {
      \"externalIdentifierType\": \"Instagram\",
      \"id\": \"Instagram\"
    }
  ],
  \"partyCharacteristic\": [
    {
      \"name\": \"notes\",
      \"value\": \"Testing for update the notes\",
      \"valueType\": \"string\",
      \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"customer\",
      \"value\": \"true\",
      \"valueType\": \"boolean\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"registrationCode\",
      \"value\": \"001\",
      \"valueType\": \"string\",
       \"@type\": \"StringCharacteristics\"
    },
    {
     \"name\": \"vendorType\",
     \"value\": [\"Hardware\"],
     \"valueType\": \"array\",
      \"@type\": \"StringArrayCharacteristic\"
     },
     {
      \"name\": \"industry\",
      \"value\": \"technology_services\",
      \"valueType\": \"choice\",
        \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"taxId\",
      \"value\": \"CTNUM1000123\",
      \"valueType\": \"string\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"numEmployees\",
      \"value\": \"EMP1000\",
      \"valueType\": \"integer\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"rankTier\",
      \"value\": \"rankTier\",
      \"valueType\": \"string\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"publiclyTraded\",
      \"value\": \"false\",
      \"valueType\": \"boolean\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"stockSymbol\",
      \"value\": \"Market\",
      \"valueType\": \"string\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"stockPrice\",
      \"value\": \"1000\",
      \"valueType\": \"string\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"vendor\",
      \"value\": \"false\",
      \"valueType\": \"boolean\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"manufacturer\",
      \"value\": \"false\",
      \"valueType\": \"boolean\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"marketCap\",
      \"value\": \"0\",
      \"valueType\": \"currency\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"profits\",
      \"value\": \"0\",
      \"valueType\": \"currency\",
       \"@type\": \"StringCharacteristics\"
    },
    {
      \"name\": \"revenuePerYear\",
      \"value\": \"0\",
      \"valueType\": \"currency\",
       \"@type\": \"StringCharacteristics\"
    }
  ],
  \"relatedParty\": [
    {
      \"@type\": \"User\",
      \"role\": \"primaryContact\"
    },
    {
      \"role\": \"other\" 
    }
  ],
  \"organizationChildRelationship\": [
    {
      \"relationshipType\": \"partneraccount\",
      \"organization\": {
        \"id\": \"0fef075b2fe06a10b79db3bf42faf31a\",
        \"name\": \"mhd\",
        \"@type\": \"Organization\"
      }
    }
  ],
  \"organizationParentRelationship\": 
    {
      \"relationshipType\": \"Account\",
      \"organization\": {
        \"id\": \"9e2fd2ee11b43110f877366201dea674\",
        \"name\": \"Global Holdings Ltd.\",
        \"@type\": \"Organization\"
      }
    },
  \"status\": \"active\",
  \"@type\": \"User\"
}" \
```

Response body.

```
{
  "name": "SERVICENOW 144",
  "legalName": "Acme Corp Ltd.",
  "tradingName": "Acme Inc.",
  "contactMedium": [
    {
      "preferred": true,
      "mediumType": "email",
      "emailAddress": "athammhd@email.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "phone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "businessPhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "homePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "postalAddress",
      "validFor": {
        "startDateTime": "2017-03-15T07:49:25.246Z"
      },
      "@type": "GeographicAddressContactMedium",
      "city": "chennai",
      "country": "INDIA",
      "postCode": "608001",
      "stateOrProvince": "tamil nadu",
      "street1": "samcon street",
      "street2": "adyar,chennai"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "Instagram",
      "id": "Instagram"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "Testing for update the notes",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "customer",
      "value": "true",
      "valueType": "boolean",
       "@type": "StringCharacteristics"
    },
    {
      "name": "registrationCode",
      "value": "001",
      "valueType": "string",
       "@type": "StringCharacteristics"
    },
    {
     "name": "vendorType",
     "value": ["Hardware"],
     "valueType": "array",
      "@type": "StringArrayCharacteristic"
     },
     {
      "name": "industry",
      "value": "technology_services",
      "valueType": "choice",
        "@type": "StringCharacteristics"
    },
    {
      "name": "taxId",
      "value": "CTNUM1000123",
      "valueType": "string",
       "@type": "StringCharacteristics"
    },
    {
      "name": "numEmployees",
      "value": "EMP1000",
      "valueType": "integer",
       "@type": "StringCharacteristics"
    },
    {
      "name": "rankTier",
      "value": "rankTier",
      "valueType": "string",
       "@type": "StringCharacteristics"
    },
    {
      "name": "publiclyTraded",
      "value": "false",
      "valueType": "boolean",
       "@type": "StringCharacteristics"
    },
    {
      "name": "stockSymbol",
      "value": "Market",
      "valueType": "string",
       "@type": "StringCharacteristics"
    },
    {
      "name": "stockPrice",
      "value": "1000",
      "valueType": "string",
       "@type": "StringCharacteristics"
    },
    {
      "name": "vendor",
      "value": "false",
      "valueType": "boolean",
       "@type": "StringCharacteristics"
    },
    {
      "name": "manufacturer",
      "value": "false",
      "valueType": "boolean",
       "@type": "StringCharacteristics"
    },
    {
      "name": "marketCap",
      "value": "0",
      "valueType": "currency",
       "@type": "StringCharacteristics"
    },
    {
      "name": "profits",
      "value": "0",
      "valueType": "currency",
       "@type": "StringCharacteristics"
    },
    {
      "name": "revenuePerYear",
      "value": "0",
      "valueType": "currency",
       "@type": "StringCharacteristics"
    }
  ],
  "relatedParty": [
    {
      "@type": "User",
      "role": "primaryContact",
    },
    {
      "role": "other"
    }
  ],
  "organizationChildRelationship": [
    {
      "relationshipType": "partneraccount",
      "organization": {
        "id": "0fef075b2fe06a10b79db3bf42faf31a",
        "name": "mhd",
        "@type": "Organization"
      }
    }
  ],
  "organizationParentRelationship": 
    {
      "relationshipType": "Account",
      "organization": {
        "id": "9e2fd2ee11b43110f877366201dea674",
        "name": "Global Holdings Ltd.",
        "@type": "Organization"
      }
    },
  "status": "active",
  "@type": "User",
}
```

## Party Management - POST /api/sn\_tmf\_api/v1/party/individual

Creates a new individual party management record in the Consumer \[csm\_consumer\] or Contact \[customer\_contact\] tables.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/individual`

Default URL: `/api/sn_tmf_api/v1/party/individual`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

<table id="id_tzm_xm4_3hc" class="rest_api_request_body"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   `BusinessPhoneContactMedium`: Business phone number
-   `EmailContactMedium`: Email address
-   `FaxPhoneContactMedium`: Fax number
-   `GeographicAddressContactMedium`: Physical address: street, city, state, postal code
-   `HomePhoneContactMedium`: Home phone number
-   `MobilePhoneContactMedium`: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is in a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this parameter defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual isn't in an active status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

|Status code|Description|
|-----------|-----------|
|200|Successful. The request was successfully processed.|

### Response body parameters \(JSON or XML\)

<table id="id_vql_zm4_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "mediumType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the individual. Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the individual.Data type: String

</td></tr><tr><td>

contactMedium.emailAddress

</td><td>

Email address of the contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the party location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Indicates the business-level attribute that specifies the kind of contact channel being used.Possible values:

-   email
-   businessPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the individual.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the individual.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always false.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

familyName

</td><td>

Last name of the individual.Data type: String

</td></tr><tr><td>

gender

</td><td>

Gender of the individual.Data type: String

</td></tr><tr><td>

givenName

</td><td>

First name of the individual.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the user or consumer or contact record.Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\]

Data type: String

</td></tr><tr><td>

middleName

</td><td>

Middle name of the individual.Data type: String

</td></tr><tr><td>

name

</td><td>

User name of the user or contact individual.Data type: String

</td></tr><tr><td>

nationality

</td><td>

Nationality of the individual.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics associated with the party.Data type: Array of Objects

```
"partyCharacteristics": [
 {
  "@type": "String",
  "name": " String",
  "value": "String",
  "valueType": "String"
 }
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, this defines the subclass extensible name.Possible values:

-   StringCharacteristic
-   StringArrayCharacteristic
-   IntegerCharacteristic
-   BooleanCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of the individual.Valid values:

-   active: Individual is in an active status.
-   inactive: Individual is in an inactive status.

Data type: Boolean

</td></tr><tr><td>

title

</td><td>

Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

</td></tr></tbody>
</table>### cURL request

This returns specified fields for the party management individual records.

```
curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user 'user':'password'
--data "{
    \"id\": \"98765\",
    \"name\": \"Jane Smith\",
    \"givenName\": \"Jane\",
    \"middleName\": \"B.\",
    \"familyName\": \"Smith\",
    \"gender\": \"female\",
    \"nationality\": \"American\",
    \"title\": \"Ms\",
    \"contactMedium\": [
      {
        \"preferred\": true,
        \"mediumType\": \"email\",
        \"emailAddress\": \"jane.smith@example.com\",
        \"@type\": \"EmailContactMedium\"
      },
      {
        \"preferred\": false,
        \"mediumType\": \"mobilePhone\",
        \"phoneNumber\": \"+1-416-555-1234\",
        \"@type\": \"PhoneContactMedium\"
      },
      {
        \"preferred\": false,
        \"mediumType\": \"businessPhone\",
        \"phoneNumber\": \"+1-416-555-5678\",
        \"@type\": \"BusinessPhoneContactMedium\"
      },
      {
        \"preferred\": false,
        \"mediumType\": \"fax\",
        \"fax\": \"987654321\",
        \"@type\": \"FaxContactMedium\"
      },
      {
        \"preferred\": false,
        \"mediumType\": \"homePhone\",
        \"phoneNumber\": \"+1-416-555-4321\",
        \"@type\": \"HomePhoneContactMedium\"
      },
      {
        \"preferred\": false,
        \"mediumType\": \"postalAddress\",
        \"@type\": \"GeographicAddressContactMedium\",
        \"locationId\": \"12345678901234567\",
        \"city\": \"Toronto\",
        \"country\": \"Canada\",
        \"postCode\": \"M5H 2N2\",
        \"stateOrProvince\": \"Ontario\",
        \"street1\": \"123 Queen St W\",
        \"street2\": \"Suite 1500\"
      }
    ],
    \"externalReference\": [
      {
        \"externalIdentifierType\": \"linkedin\",
        \"id\": \"http://linkedin.com/in/janesmith\"
      }
    ],
    \"partyCharacteristic\": [
      {
        \"name\": \"notes\",
        \"value\": \"General consumer information.\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"userName\",
        \"value\": \"janesmith\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"vip\",
        \"value\": false,
        \"valueType\": \"boolean\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"source\",
        \"value\": \"CRM System\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"dateFormat\",
        \"value\": \"yyyy-mm-dd\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"timeformat\",
        \"value\": \"HH:mm:ss (24 hour)\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      },
      {
        \"name\": \"notification\",
        \"value\": \"Disabled\",
        \"valueType\": \"string\",
        \"@type\": \"string\"
      }
    ],
    \"relatedParty\": [
      {
        \"@type\": \"User\"
        \"role\": \"User\"
      }
    ],
    \"status\": \"active\",
    \"@type\": \"User\",
  }" \

```

Response body.

```
{
  "id": "83e588a17b6062105e0d5494548cb65d",
  "href": "api/sn_tmf_api/party/individual/83e588a17b6062105e0d5494548cb65d",
  "name": "Jane Smith",
  "givenName": "Jane",
  "middleName": "B.",
  "familyName": "Smith",
  "gender": "female",
  "nationality": "American",
  "title": "Ms",
  "contactMedium": [
    {
      "preferred": true,
      "mediumType": "email",
      "emailAddress": "jane.smith@example.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "mobilePhone",
      "phoneNumber": "+1-416-555-1234",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "businessPhone",
      "phoneNumber": "+1-416-555-5678",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "fax",
      "fax": "987654321",
      "@type": "FaxContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "homePhone",
      "phoneNumber": "+1-416-555-4321",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "mediumType": "postalAddress",
      "@type": "GeographicAddressContactMedium",
      "locationId": "03e588a17be062105e0d5494548cb68c",
      "city": "Toronto",
      "country": "Canada",
      "postCode": "M5H 2N2",
      "stateOrProvince": "Ontario",
      "street1": "123 Queen St W",
      "street2": "Suite 1500"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "linkedin",
      "id": "http://linkedin.com/in/janesmith"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "General consumer information.",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "userName",
      "value": "janesmith",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "vip",
      "value": false,
      "valueType": "boolean",
      "@type": "string"
    },
    {
      "name": "source",
      "value": "CRM System",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "dateFormat",
      "value": "yyyy-mm-dd",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "timeformat",
      "value": "HH:mm:ss (24 hour)",
      "valueType": "string",
      "@type": "string"
    },
    {
      "name": "notification",
      "value": "Disabled",
      "valueType": "string",
      "@type": "string"
    }
  ],
  "relatedParty": {
    "@type": "User",
    "role": "User"
  }
},
  "status": "active",
  "@type": "User",
   "warning": [
    "relatedParty[0] is incorrect. User does not exist"
  ]
}
```

## Party Management - POST /api/sn\_tmf\_api/v1/party/organization

Creates a new party organization record in the Account \[customer\_account\] tables. You can also create and associate Contact and Location records inline during organization creation, eliminating the need for separate POST operations.

### Automatic Location Creation with contactMedium

When you include address information in the **contactMedium** field \(with **@type** set to `GeographicAddressContactMedium`\), the system automatically handles location creation and association based on what you provide:

1.  If you supply a valid locationId, the system links the existing location record to the organization you are creating.
2.  If you provide address attributes \(street, city, country, postCode, stateOrProvince\) along with an invalid or non-existent locationId, the system automatically creates a new location record with those attributes and associates it to the organization.
3.  If you provide address attributes without specifying a locationId at all, the system creates a new location record and associates it to the organization.

**Note:** Location creation requires no mandatory fields. You can provide any combination of address attributes \(street1, street2, city, state, postCode, country\) based on your needs. If you omit all address attributes from the contactMedium section, no location record is created or linked to the organization.

### Inline Contact Creation with relatedParty

When you include contact attributes in the **relatedParty** field without providing a contact ID, the system automatically creates a new contact record and associates it to the organization you are creating. This eliminates the need for a separate POST request to create the contact first. You can include the following contact information directly in the **relatedParty.partyOrPartyRole** object.

Mandatory attributes for inline contact creation:

-   familyName \(or lastName\)
-   email

Optional attributes:

-   givenName
-   middleName
-   gender
-   title
-   nationality
-   contactMedium \(to include phone, address, or other contact details\)

Example: Creating a contact inline without a pre-existing ID.

```
{
  "relatedParty": [
    {
      "role": "primaryContact",
      "partyOrPartyRole": {
        "givenName": "John",
        "familyName": "Doe",
        "email": "john.doe@example.com",
        "@type": "Individual"
      }
    }
  ]
}
```

Legacy approach: Linking an existing contact by ID.

If you already have a contact record, you can link it by providing its sys\_id instead:

```
{
  "relatedParty": [
    {
      "role": "primaryContact",
      "partyOrPartyRole": {
        "id": "existing_contact_sys_id",
        "name": "John Doe",
        "@type": "Individual"
      }
    }
  ]
}
```

Both approaches are supported. The system automatically determines whether to create a new contact or link an existing one based on whether the partyOrPartyRole includes an id field.

### URL format

Versioned URL: `/api/sn_tmf_api/v1/party/organization`

Default URL: `/api/sn_tmf_api/v1/party/organization`

### Supported request parameters

<table class="rest_api_path_parameters"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api\_version

</td><td id="version-entry-RESTAPI">

Optional. Version of the endpoint to access. For example, `v1` or `v2`. Only specify this value to use an endpoint version other than the latest. Data type: String

</td></tr></tbody>
</table>|Name|Description|
|----|-----------|
|None| |

<table id="id_gby_knj_jhc" class="rest_api_request_body"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.contactType

</td><td>

The type of contact medium. Possible values:

-   `businessPhone`
-   `email`
-   `faxPhone`
-   `homePhone`
-   `mobilePhone`
-   `postalAddress`

Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   `state`
-   `province`

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

organizationChildRelationship

</td><td>

List of child organization relationships, such as subsidiary, partner, or branch organizations. Data type: Array of Objects

```
"organizationChildRelationship": [
  {
    "relationshipType": "String",
    "organization": {Object}
  }
]
```

</td></tr><tr><td>

organizationChildRelationship.organization

</td><td>

Child organization object containing identity and details.Data type: Object

```
"organization": {
        "id": "String",
        "name": "String",
        "@type": "String"
      }
```

</td></tr><tr><td>

organizationChildRelationship.organization.@type

</td><td>

Type of the organization object. Value is always `Organization`.Data type: String

</td></tr><tr><td>

organizationChildRelationship.organization.id

</td><td>

Sys\_id of the child organization record.Table: Account \[customer\_account\] or Organization \[core\_company\]

Data type: String

</td></tr><tr><td>

organizationChildRelationship.organization.name

</td><td>

Display name of the child organization.Data type: String

</td></tr><tr><td>

organizationChildRelationship.relationshipType

</td><td>

Type of relationship between parent and child organization.Data type: String

Accepted values:

-   `partneraccount`
-   `distributor`
-   `subsidiary`
-   `branch`
-   `reseller`

</td></tr><tr><td>

organizationParentRelationship

</td><td>

Parent organization relationship. Data type: Object

```
"organizationParentRelationship": {
  "relationshipType": "String",
  "organization": {Object}
}
```

</td></tr><tr><td>

organizationParentRelationship.organization

</td><td>

Parent organization object containing identity and details.Data type: Object

```
"organization": {
      "id": "String",
      "name": "String",
      "@type": "String"
    }
```

</td></tr><tr><td>

organizationParentRelationship.organization.@type

</td><td>

Type of the organization object. Value is always `Organization`.Data type: String

</td></tr><tr><td>

organizationParentRelationship.organization.id

</td><td>

Sys\_id of the parent organization record. Table: Account \[customer\_account\] or Organization \[core\_company\]

Data type: String

</td></tr><tr><td>

organizationParentRelationship.organization.name

</td><td>

Display name of the parent organization.Data type: String

</td></tr><tr><td>

organizationParentRelationship.relationshipType

</td><td>

Type of relationship between this organization and its parent.Accepted values:

-   `Account`
-   `Company`
-   `HoldingCompany`
-   `ParentAccount`

Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Accepted values:

-   notes
-   customer
-   registrationCode
-   vendorType
-   industry
-   taxId
-   numEmployees
-   rankTier
-   publiclyTraded
-   stockSymbolstockPrice
-   vendor
-   manufacturer
-   marketCap
-   profits
-   revenuePerYear
-   vendorType

**Note:** The **partyCharacteristic.value** attribute accepts the display value of `rankTier` and `industry` choice fields as input. Invalid values will trigger a warning message in the response.

Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### Headers

The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table class="rest_api_request_headers"><thead><tr><th>

Header

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Accept

</td><td id="accept-entry-RESTAPI">

Data format of the response body. Supported types: **application/json** or **application/xml**. Default: **application/json**

</td></tr></tbody>
</table>|Header|Description|
|------|-----------|
|None| |

### Status codes

The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md).

<table><thead><tr><th>

Status code

</th><th>

Description

</th></tr></thead><tbody><tr><td>

200

</td><td>

Successful. The request was successfully processed.**Note:** Response may include a **warning** array if:

-   Invalid **relatedParty** IDs are provided \(related contact or party doesn't exist\).
-   Invalid **locationId** is provided in **contactMedium**. Example warning: `relatedParty[0] is incorrect. User does not exist`.

</td></tr></tbody>
</table>### Response body parameters \(JSON or XML\)

### Response body parameters \(JSON or XML\)

<table id="table_edn_qnn_3hc"><thead><tr><th>

Name

</th><th>

Description

</th></tr></thead><tbody><tr><td>

@type

</td><td>

Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values:

-   `Account`
-   `Consumer`
-   `Contact`

Data type: String

</td></tr><tr><td>

contactMedium

</td><td>

List of means for contacting the party. A contact medium represents the way you communicate with or reach a party like an individual or organization. For example, a channel or method of contact associated with that party.Data type: Array of Objects

```
"contactMedium": [
 {
  "@type": "String",
  "city": "String",
  "country": "String",
  "emailAddress": "String",
  "locationId": "String",
  "contactType": "String",
  "phoneNumber": "String",
  "postCode": "String",
  "preferred": "Boolean",
  "stateOrProvince": "String",
  "street1": "String",
  "street2": "String"
 }
]
```

</td></tr><tr><td>

contactMedium.@type

</td><td>

Type of contact medium. Type of contacting party. Indicates the specific schema or subclass type of the object.Possible values:

-   BusinessPhoneContactMedium: Business phone number
-   EmailContactMedium: Email address
-   FaxPhoneContactMedium: Fax number
-   GeographicAddressContactMedium: Physical address \(street, city, state, postal code\)
-   HomePhoneContactMedium: Home phone number
-   MobilePhoneContactMedium: Mobile number

Data type: String

</td></tr><tr><td>

contactMedium.city

</td><td>

City of the organization.Data type: String

</td></tr><tr><td>

contactMedium.country

</td><td>

Country of the organization.Data type: String

</td></tr><tr><td>

contactMedium.emailAdress

</td><td>

Email address of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.locationId

</td><td>

Sys\_id of the location.Table: Location \[cmn\_location\]

Data type: String

</td></tr><tr><td>

contactMedium.mediumType

</td><td>

The type of contact medium. Possible values:

-   businessPhone
-   email
-   faxPhone
-   homePhone
-   mobilePhone
-   postalAddress

Data type: String

</td></tr><tr><td>

contactMedium.phoneNumber

</td><td>

Phone number of the organization contact.Data type: String

</td></tr><tr><td>

contactMedium.postCode

</td><td>

Postcode of the organization.Data type: String

</td></tr><tr><td>

contactMedium.preferred

</td><td>

This value is always `false`.Data type: Boolean

</td></tr><tr><td>

contactMedium.stateOrProvince

</td><td>

Indicates whether the location is from a state or province.Possible values:

-   state
-   province

Data type: String

</td></tr><tr><td>

contactMedium.street1

</td><td>

Describes the street.Data type: String

</td></tr><tr><td>

contactMedium.street2

</td><td>

Complementary street description.Data type: String

</td></tr><tr><td>

createdDate

</td><td>

Timestamp when the organization record was created \(ISO 8601 format\). Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

externalId

</td><td>

An external system identifier that links the party record to your source system or third-party application.Data type: String

</td></tr><tr><td>

externalReference

</td><td>

List of identifiers of the party in an external system.Data type: Array of Objects

```
"externalReference": [ 
 { 
  "externalIdentifierType": "String", 
  "name": "String" 
 }
]
```

</td></tr><tr><td>

externalReference.externalIdentifierType

</td><td>

Type of entity within the external system.Data type: String

</td></tr><tr><td>

externalReference.name

</td><td>

Human-readable name of the external system or reference.Data type: String

</td></tr><tr><td>

href

</td><td>

Relative link to the account record \(URI\).Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

id

</td><td>

Sys\_id of the external entity account record.Table: Account \[customer\_account\]

Data type: String

</td></tr><tr><td>

lastModifiedDate

</td><td>

Timestamp when the organization record was last modified \(ISO 8601 format\).Data type: String

Example: "2025-06-25T14:32:18.000Z"

</td></tr><tr><td>

legalName

</td><td>

Legal name of the organization.Data type: String

</td></tr><tr><td>

name

</td><td>

Name of the organization.Data type: String

</td></tr><tr><td>

partyCharacteristics

</td><td>

List of characteristics that a party can take on. Data type: Array of Objects

```
"partyCharacteristics": [ 
 { 
  "@type": "String" 
  "name": "String",   
  "value": "String", 
  "valueType": "String"
 } 
]
```

</td></tr><tr><td>

partyCharacteristics.@type

</td><td>

When subclassing, **@type** defines the subclass extensible name.Possible value:

-   BooleanCharacteristic
-   IntegerCharacteristic
-   StringArrayCharacteristic
-   StringCharacteristic

Data type: String

</td></tr><tr><td>

partyCharacteristics.name

</td><td>

Name of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.value

</td><td>

Value of the party characteristic.Data type: String

</td></tr><tr><td>

partyCharacteristics.valueType

</td><td>

Data type of the characteristic's value.Data type: String

</td></tr><tr><td>

relatedParty

</td><td>

List of parties or party roles related to this party.Data type: Array of Objects

```
"relatedParty": [
 {
  "@type": "User",
  "role": "String"
 }
]
```

</td></tr><tr><td>

relatedParty.@type

</td><td>

The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer.Data type: String

</td></tr><tr><td>

relatedParty.role

</td><td>

Functional, business role that the related party plays in the context of the current entity.Possible values:

-   Company \(if related party is User\)
-   Department \(if related party is User\)
-   Account \(if related party is Customer\)
-   User \(if related party is Consumer\)

Data type: String

</td></tr><tr><td>

status

</td><td>

Flag that indicates the status of organization.Valid values:

-   active: Organization is active.
-   inactive: Organization is inactive.

Data type: Boolean

</td></tr><tr><td>

tradingName

</td><td>

Name that the organization trades under.Data type: String

</td></tr></tbody>
</table>### cURL request

This returns specified fields for the party management organization records.

```
curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \
  --request POST \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --user 'user:password' \
  --data '{
  "name": "SERVICENOW 144",
  "legalName": "Acme Corp Ltd.",
  "tradingName": "Acme Inc.",
  "contactMedium": [
    {
      "preferred": true,
      "contactType": "email",
      "emailAddress": "athammhd@email.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "contactType": "mobilePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "businessPhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "homePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "postalAddress",
      "validFor": {
        "startDateTime": "2017-03-15T07:49:25.246Z"
      },
      "@type": "GeographicAddressContactMedium",
      "locationId": "12345678901234567",
      "city": "chennai",
      "country": "INDIA",
      "postCode": "608001",
      "stateOrProvince": "tamil nadu",
      "street1": "samcon street",
      "street2": "adyar,chennai"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "Instagram",
      "id": "Instagram"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "Testing for update the notes",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "customer",
      "value": "true",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "registrationCode",
      "value": "001",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "vendorType",
      "value": ["Hardware"],
      "valueType": "array",
      "@type": "StringArrayCharacteristic"
    },
    {
      "name": "industry",
      "value": "Manufacturing",
      "valueType": "choice",
      "@type": "StringCharacteristics"
    },
    {
      "name": "taxId",
      "value": "CTNUM1000123",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "numEmployees",
      "value": "10",
      "valueType": "integer",
      "@type": "StringCharacteristics"
    },
    {
      "name": "rankTier",
      "value": "Valued Partner",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "publiclyTraded",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "stockSymbol",
      "value": "Market",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "stockPrice",
      "value": "1000",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "vendor",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "manufacturer",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "marketCap",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    },
    {
      "name": "profits",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    },
    {
      "name": "revenuePerYear",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    }
  ],
  "relatedParty": [
    {
      "role": "primaryContact",
      "partyOrPartyRole": {
        "givenName": "John",
        "familyName": "Doe",
        "email": "john.doe@example.com",
        "@type": "Individual"
      }
    },
    {
      "role": "other",
      "partyOrPartyRole": {
        "givenName": "Mary",
        "familyName": "Star",
        "email": "mary.star@example.com",
        "@type": "Individual"
      }
    }
  ],
  "organizationChildRelationship": [
    {
      "relationshipType": "partneraccount",
      "organization": {
        "id": "0fef075b2fe06a10b79db3bf42faf31a",
        "name": "mhd",
        "@type": "Organization"
      }
    }
  ],
  "organizationParentRelationship": {
    "relationshipType": "Account",
    "organization": {
      "id": "9e2fd2ee11b43110f877366201dea674",
      "name": "Global Holdings Ltd.",
      "@type": "Organization"
    }
  },
  "status": "active",
  "@type": "Organization"
}'
```

Response body.

```
{
  "id": "0fef075b2fe06a10b79db3bf42faf31c",
  "href": "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization/0fef075b2fe06a10b79db3bf42faf31c",
  "name": "SERVICENOW 144",
  "legalName": "Acme Corp Ltd.",
  "tradingName": "Acme Inc.",
  "contactMedium": [
    {
      "preferred": true,
      "contactType": "email",
      "emailAddress": "athammhd@email.com",
      "@type": "EmailContactMedium"
    },
    {
      "preferred": false,
      "contactType": "mobilePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "PhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "businessPhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "BusinessPhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "homePhone",
      "phoneNumber": "+1-202-555-0198",
      "@type": "HomePhoneContactMedium"
    },
    {
      "preferred": false,
      "contactType": "postalAddress",
      "validFor": {
        "startDateTime": "2017-03-15T07:49:25.246Z"
      },
      "@type": "GeographicAddressContactMedium",
      "locationId": "03e588a17be062105e0d5494548cb68c",
      "city": "chennai",
      "country": "INDIA",
      "postCode": "608001",
      "stateOrProvince": "tamil nadu",
      "street1": "samcon street",
      "street2": "adyar,chennai"
    }
  ],
  "externalReference": [
    {
      "externalIdentifierType": "Instagram",
      "id": "Instagram"
    }
  ],
  "partyCharacteristic": [
    {
      "name": "notes",
      "value": "Testing for update the notes",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "customer",
      "value": "true",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "registrationCode",
      "value": "001",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "vendorType",
      "value": ["Hardware"],
      "valueType": "array",
      "@type": "StringArrayCharacteristic"
    },
    {
      "name": "industry",
      "value": "Manufacturing",
      "valueType": "choice",
      "@type": "StringCharacteristics"
    },
    {
      "name": "taxId",
      "value": "CTNUM1000123",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "numEmployees",
      "value": "10",
      "valueType": "integer",
      "@type": "StringCharacteristics"
    },
    {
      "name": "rankTier",
      "value": "Valued Partner",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "publiclyTraded",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "stockSymbol",
      "value": "Market",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "stockPrice",
      "value": "1000",
      "valueType": "string",
      "@type": "StringCharacteristics"
    },
    {
      "name": "vendor",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "manufacturer",
      "value": "false",
      "valueType": "boolean",
      "@type": "StringCharacteristics"
    },
    {
      "name": "marketCap",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    },
    {
      "name": "profits",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    },
    {
      "name": "revenuePerYear",
      "value": "0",
      "valueType": "currency",
      "@type": "StringCharacteristics"
    }
  ],
  "relatedParty": [
    {
      "role": "primaryContact",
      "partyOrPartyRole": {
        "id": "eaf68911c35420105252716b7d40ddde",
        "givenName": "John",
        "familyName": "Doe",
        "email": "john.doe@example.com",
        "name": "John Doe",
        "@type": "Individual"
      }
    },
    {
      "role": "other",
      "partyOrPartyRole": {
        "id": "776a22ea11f43110f877366201dea6b7",
        "givenName": "Mary",
        "familyName": "Star",
        "email": "mary.star@example.com",
        "name": "Mary Star",
        "@type": "Individual"
      }
    }
  ],
  "organizationChildRelationship": [
    {
      "relationshipType": "partneraccount",
      "organization": {
        "id": "0fef075b2fe06a10b79db3bf42faf31a",
        "name": "mhd",
        "@type": "Organization"
      }
    }
  ],
  "organizationParentRelationship": {
    "relationshipType": "Account",
    "organization": {
      "id": "9e2fd2ee11b43110f877366201dea674",
      "name": "Global Holdings Ltd.",
      "@type": "Organization"
    }
  },
  "status": "active",
  "@type": "Organization",
  "createdDate": "2025-06-25T14:32:18.000Z",
  "lastModifiedDate": "2025-06-25T14:32:18.000Z"
}
```