REST API reference › API reference › API implementation and reference

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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, 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.

Parent Topic:REST API reference

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

Name	Description
api\_version	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
id	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

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.

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

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.

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

Name	Description
api\_version	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

Name	Description
fields	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.
id	Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String
limit	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
offset	Starting index at which to begin retrieving records. Use this value to paginate record retrieval.Data type: Number Default: 0

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.

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

Header	Description
Content-Range	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.
Content-Type	Data format of the response body. Only supports application/json.
Link	Contains the following links to navigate through query results: - first - last - next - previous
X-Total-Count	For paginated queries, this header specifies the total number of records available on the server.

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.

Status code	Description
200	Request successfully processed. Full resource returned in response \(no pagination\).
206	Partial resource returned in response \(with pagination\).
400	Bad request. Possible reasons:- Invalid path parameter - Invalid URI
404	Record not found. No records matching the query parameters are found in the table.

Response body parameters (JSON or XML)

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
id	Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of party role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole	Represents information about the related party and the role it plays in the context of the record. For example, if the role is `Company`, then partyOrPartyRole.id contains the sys_id of the Company [core_company] record, and partyOrPartyRole.name contains the company’s name. This structure ensures that both the party reference and its role are explicitly defined and easily identifiable. Data type: Object `"partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" }`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party.- Possible value for `user`: - Company - Department - Possible value for `customer`: Account - Possible value for `consumer`: User Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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",
   "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": [
     {
       "role": "Company",
       "partyOrPartyRole": {
         "id": "9e2fd2ee11b43110f877366201dea674",
         "name": "Startech svcs",
         "@type": "Organization"
       }
     },
     {
       "role": "Department",
       "partyOrPartyRole": {
         "id": "",
         "name": "",
         "@type": "Organization"
       }
     }
   ],
   "status": "Active",
   "@type": "Individual",
   "partyOrPartyRole": {
     "name": "Contact",
     "@type": "Party"
   }
 }
]

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": [
     {
       "role": "User",
       "partyOrPartyRole": {
         "id": "",
         "name": "",
         "@type": "Individual"
       }
     }
   ],
   "status": "Active",
   "@type": "Individual",
   "partyOrPartyRole": {
     "name": "Consumer",
     "@type": "Party"
   }
 }
]

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

Name	Description
api\_version	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
id	Sys\_id or external\_id of the consumer or contact record to retrieve.Table: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String

Name	Description
fields	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

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
id	Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of party role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole	Represents information about the related party and the role it plays in the context of the record. For example, if the role is `Company`, then partyOrPartyRole.id contains the sys_id of the Company [core_company] record, and partyOrPartyRole.name contains the company’s name. This structure ensures that both the party reference and its role are explicitly defined and easily identifiable. Data type: Object `"partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" }`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party.- Possible value for `user`: - Company - Department - Possible value for `customer`: Account - Possible value for `consumer`: User Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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",
  "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": [
    {
      "role": "User",
      "partyOrPartyRole": {
        "id": "36901a6381116a50f8776cfcbee15f3c",
        "name": "Hr",
        "@type": "Individual"
      }
    }
  ],
  "status": "active",
  "@type": "Individual",
  "partyOrPartyRole": {
    "role": "Consumer",
    "@type":"Party"
  }
}

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

Name	Description
api\_version	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
id	Sys\_id of the company or account record to retrieve.Table: Account \[customer\_account\] or Company \[csm\_company\] Data type: String

Name	Description
fields	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
id	Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String
limit	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
offset	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

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
@type	This value is always `Organization`.Data type: String
contactMedium	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", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ]`
contactMedium.@type	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
contactMedium.city	City of the organization.Data type: String
contactMedium.country	Country of the organization.Data type: String
contactMedium.emailAdress	Email address of the organization contact.Data type: String
contactMedium.locationId	Sys\_id of the location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	The type of contact medium. Possible values: - businessPhone - email - faxPhone - homePhone - mobilePhone - postalAddress Data type: String
contactMedium.phoneNumber	Phone number of the organization contact.Data type: String
contactMedium.postCode	Postcode of the organization.Data type: String
contactMedium.preferred	This value is always `false`.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
externalReference	List of identifiers of the party in an external system.Data type: Array of Objects `"externalReference": [ { "externalIdentifierType": "String", "name": "String" } ]`
externalReference.externalIdentifierType	Type of entity within the external system.Data type: String
externalReference.name	Human-readable name of the external system or reference.Data type: String
href	Relative link to the account record \(URI\).Table: Account \[customer\_account\] Data type: String
id	Sys\_id of the external entity account record.Table: Account \[customer\_account\] Data type: String
legalName	Legal name of the organization.Data type: String
name	Name of the organization.Data type: String
partyCharacteristics	List of characteristics that a party can take on. Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, @type defines the subclass extensible name.Possible value: BooleanCharacteristic IntegerCharacteristic StringArrayCharacteristic StringCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in the table. For example, `Company` or `Account`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Account [customer_account] table, then partyOrPartyRole.role is set to `Account`. Likewise, if the sys_id belongs to the Company [core_company] table, then partyOrPartyRole.role is set to `Company`. Data type: Object `"partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", }`
PartyOrPartyRole.@type	This value is always `party`.Data type: String
PartyOrPartyRole.name	Defines the type of the account or company.Data type: String
PartyOrPartyRole.role	Type of the role.Possible value: - Account - Company Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ]`
relatedParty.partyOrPartyRole	Roles related to this party.Data type: Array of Objects `"partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Value is always `Organization`.Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party. Possible value: - Contact - Other Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	Role played by the related party or party role in the context of the specific entity it's linked to. Possible values: - Contact - Other Data type: String
status	Flag that indicates the status of organization.Valid values: - active: Organization is active. - inactive: Organization is inactive. Data type: Boolean
tradingName	Name that the organization trades under.Data type: String

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",
   "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": [
     {
       "role": "primary",
       "partyOrPartyRole": {
         "@type": "Organization",
         "id": "b88d14843bc02300bfe04d72f3efc4cd",
         "name": "Amy Chen"
       }
     },
     {
       "role": "other",
       "partyOrPartyRole": {
         "@type": "Organization",
         "id": "016b7a36ff14a610f8dfffffffffffcb",
         "name": "Kutty"
       }
     },
     {
       "role": "other",
       "partyOrPartyRole": {
         "@type": "Organization",
         "id": "e8bb9d1aff94a210f8dfffffffffff1d",
         "name": "World"
       }
     }
   ],
   "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": "Organization",
   "partyOrPartyRole": {
     "name": "customer_partner_vendor_manufacturer",
     "role": "Account",
     "@type": "Party"
   }
 }

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

Name	Description
api\_version	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

Name	Description
fields	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
id	Filter party management by sys\_id. Specified sys\_ids are returned in the response.Data type: String
limit	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
offset	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

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is in a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this parameter defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of the role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties and party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	ID for the linked entity in the Party Management or Party Role Management system. - Possible value for user: - `Company` - `Department` - Possible value for customer: `Account` - Possible value for consumer: `User` Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
None

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",
    "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": "Organization",
    "partyOrPartyRole": {
      "name": "customer_partner",
      "role": "Account",
      "@type": "Party"
    }
  }
]

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

Name	Description
api\_version	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
id	Sys\_id of the consumer or contact.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String

Name	Description
None

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is in a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this parameter defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of the role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties and party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	ID for the linked entity in the Party Management or Party Role Management system. - Possible value for user: - `Company` - `Department` - Possible value for customer: `Account` - Possible value for consumer: `User` Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
id	Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of party role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole	Represents information about the related party and the role it plays in the context of the record. For example, if the role is `Company`, then partyOrPartyRole.id contains the sys_id of the Company [core_company] record, and partyOrPartyRole.name contains the company’s name. This structure ensures that both the party reference and its role are explicitly defined and easily identifiable. Data type: Object `"partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" }`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party.- Possible value for `user`: - Company - Department - Possible value for `customer`: Account - Possible value for `consumer`: User Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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\": [
    {
      \"role\": \"Company\",
      \"partyOrPartyRole\": {
        \"id\": \"86c1f3193790200044e0bfc8bcbe5d95\",
        \"name\": \"Acme Corporation\",
        \"@type\": \"Organization\"
      }
    },
    {
      \"role\": \"Department\",
      \"partyOrPartyRole\": {
        \"id\": \"c3fdd27a7b9822105e0d5494548cb6b0\",
        \"name\": \"Acme Corporation\",
        \"@type\": \"Organization\"
      }
    }
  ],
  \"status\": \"active\",
  \"@type\": \"Individual\",
  \"partyOrPartyRole\": {
    \"role\": \"Consumer\",
    \"@type\":\"Party\"
  }
}" \

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": [
    {
      "role": "User",
      "partyOrPartyRole": {
        "id": "c456def03710200044e0bfc8bcbe5d99",
        "name": "Global Corp",
        "@type": "Individual"
      }
    }
  ],
  "status": "active",
  "@type": "Individual",
  "partyOrPartyRole": {
    "role": "Consumer",
    "@type": "Party"
  },
   "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

Name	Description
api\_version	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

Name	Description
None

Name	Description
@type	This value is always `Organization`.Data type: String
contactMedium	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", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ]`
contactMedium.@type	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
contactMedium.city	City of the organization.Data type: String
contactMedium.country	Country of the organization.Data type: String
contactMedium.emailAdress	Email address of the organization contact.Data type: String
contactMedium.locationId	Sys\_id of the location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	The type of contact medium. Possible values: - businessPhone - email - faxPhone - homePhone - mobilePhone - postalAddress Data type: String
contactMedium.phoneNumber	Phone number of the organization contact.Data type: String
contactMedium.postCode	Postcode of the organization.Data type: String
contactMedium.preferred	This value is always `false`.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
externalReference	List of identifiers of the party in an external system.Data type: Array of Objects `"externalReference": [ { "externalIdentifierType": "String", "name": "String" } ]`
externalReference.externalIdentifierType	Type of entity within the external system.Data type: String
externalReference.name	Human-readable name of the external system or reference.Data type: String
href	Relative link to the account record \(URI\).Table: Account \[customer\_account\] Data type: String
id	Sys\_id of the external entity account record.Table: Account \[customer\_account\] Data type: String
legalName	Legal name of the organization.Data type: String
name	Name of the organization.Data type: String
partyCharacteristics	List of characteristics that a party can take on. Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, @type defines the subclass extensible name.Possible value: BooleanCharacteristic IntegerCharacteristic StringArrayCharacteristic StringCharacteristic Data type: String
partyCharacteristics.name	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
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in the table. For example, `Company` or `Account`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Account [customer_account] table, then partyOrPartyRole.role is set to `Account`. Likewise, if the sys_id belongs to the Company [core_company] table, then partyOrPartyRole.role is set to `Company`. Data type: Object `"partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", }`
PartyOrPartyRole.@type	This value is always `party`.Data type: String
PartyOrPartyRole.name	Defines the type of the account or company.Data type: String
PartyOrPartyRole.role	Type of the role.Possible value: - Account - Company Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ]`
relatedParty.partyOrPartyRole	Roles related to this party.Data type: Array of Objects `"partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Value is always `Organization`.Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party. Possible value: - Contact - Other Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	Role played by the related party or party role in the context of the specific entity it's linked to. Possible values: - Contact - Other Data type: String
status	Flag that indicates the status of organization.Valid values: - active: Organization is active. - inactive: Organization is inactive. Data type: Boolean
tradingName	Name that the organization trades under.Data type: String

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
@type	This value is always `Organization`.Data type: String
contactMedium	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", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ]`
contactMedium.@type	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
contactMedium.city	City of the organization.Data type: String
contactMedium.country	Country of the organization.Data type: String
contactMedium.emailAdress	Email address of the organization contact.Data type: String
contactMedium.locationId	Sys\_id of the location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	The type of contact medium. Possible values: - businessPhone - email - faxPhone - homePhone - mobilePhone - postalAddress Data type: String
contactMedium.phoneNumber	Phone number of the organization contact.Data type: String
contactMedium.postCode	Postcode of the organization.Data type: String
contactMedium.preferred	This value is always `false`.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
externalReference	List of identifiers of the party in an external system.Data type: Array of Objects `"externalReference": [ { "externalIdentifierType": "String", "name": "String" } ]`
externalReference.externalIdentifierType	Type of entity within the external system.Data type: String
externalReference.name	Human-readable name of the external system or reference.Data type: String
href	Relative link to the account record \(URI\).Table: Account \[customer\_account\] Data type: String
id	Sys\_id of the external entity account record.Table: Account \[customer\_account\] Data type: String
legalName	Legal name of the organization.Data type: String
name	Name of the organization.Data type: String
partyCharacteristics	List of characteristics that a party can take on. Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, @type defines the subclass extensible name.Possible value: BooleanCharacteristic IntegerCharacteristic StringArrayCharacteristic StringCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in the table. For example, `Company` or `Account`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Account [customer_account] table, then partyOrPartyRole.role is set to `Account`. Likewise, if the sys_id belongs to the Company [core_company] table, then partyOrPartyRole.role is set to `Company`. Data type: Object `"partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", }`
PartyOrPartyRole.@type	This value is always `party`.Data type: String
PartyOrPartyRole.name	Defines the type of the account or company.Data type: String
PartyOrPartyRole.role	Type of the role.Possible value: - Account - Company Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ]`
relatedParty.partyOrPartyRole	Roles related to this party.Data type: Array of Objects `"partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Value is always `Organization`.Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party. Possible value: - Contact - Other Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	Role played by the related party or party role in the context of the specific entity it's linked to. Possible values: - Contact - Other Data type: String
status	Flag that indicates the status of organization.Valid values: - active: Organization is active. - inactive: Organization is inactive. Data type: Boolean
tradingName	Name that the organization trades under.Data type: String

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\": [
    {
      \"role\": \"primaryContact\",
      \"partyOrPartyRole\": {
        \"id\": \"eaf68911c35420105252716b7d40ddde\",
        \"name\": \"John Doe\",
        \"@type\": \"Individual\"
      }
    },
    {
      \"role\": \"other\",
      \"partyOrPartyRole\": {
        \"id\": \"776a22ea11f43110f877366201dea6b7\",
        \"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\",
  \"partyOrPartyRole\": {
    \"@type\":\"Party\",
    \"name\":\"Customer\",
    \"role\": \"Account\" 
  }
}" \

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": [
    {
      "role": "primaryContact",
      "partyOrPartyRole": {
        "id": "eaf68911c35420105252716b7d40ddde",
        "name": "John Doe",
        "@type": "Individual"
      }
    },
    {
      "role": "other",
      "partyOrPartyRole": {
        "id": "776a22ea11f43110f877366201dea6b7",
        "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",
  "partyOrPartyRole": {
    "@type":"Party",
    "name":"Customer",
    "role": "Account" 
  }
}

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

Name	Description
api\_version	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

Name	Description
None

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is in a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this parameter defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of the role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties and party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	ID for the linked entity in the Party Management or Party Role Management system. - Possible value for user: - `Company` - `Department` - Possible value for customer: `Account` - Possible value for consumer: `User` Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
contactMedium	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" } ]`
contactMedium.@type	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
contactMedium.city	City of the individual. Data type: String
contactMedium.country	Country of the individual.Data type: String
contactMedium.emailAddress	Email address of the contact.Data type: String
contactMedium.locationId	Sys\_id of the party location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	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
contactMedium.phoneNumber	Phone number of the individual.Data type: String
contactMedium.postCode	Postcode of the individual.Data type: String
contactMedium.preferred	This value is always false.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
familyName	Last name of the individual.Data type: String
gender	Gender of the individual.Data type: String
givenName	First name of the individual.Data type: String
href	Relative link to the user or consumer or contact record.Data type: String
id	Sys\_id of the user or consumer or contact record to retrieve.Tables: Consumer \[csm\_consumer\] or Contact \[customer\_contact\] Data type: String
middleName	Middle name of the individual.Data type: String
name	User name of the user or contact individual.Data type: String
nationality	Nationality of the individual.Data type: String
partyCharacteristics	List of characteristics associated with the party.Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String", "name": " String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, this defines the subclass extensible name.Possible values: - StringCharacteristic - StringArrayCharacteristic - IntegerCharacteristic - BooleanCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in table. For example, `User`, `Consumer`, `Customer Contact`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Consumer [csm_consumer] table, then partyOrPartyRole.role is set to `Consumer`. Likewise, if the sys_id belongs to the Contact [customer_contact] table, then partyOrPartyRole.role is set to `Contact`. Data type: Object `"partyOrPartyRole": { "@type": "String", "role":"String" }`
partyOrPartyRole.@type	This value is always `Party`.Data type: String
partyOrPartyRole.role	Type of party role. Possible values: - Consumer - Contact Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "role": "String", "partyOrPartyRole": {Object} } ]`
relatedParty.partyOrPartyRole	Represents information about the related party and the role it plays in the context of the record. For example, if the role is `Company`, then partyOrPartyRole.id contains the sys_id of the Company [core_company] record, and partyOrPartyRole.name contains the company’s name. This structure ensures that both the party reference and its role are explicitly defined and easily identifiable. Data type: Object `"partyOrPartyRole": { "@type": "String", "id": "String", "name": "String" }`
relatedParty.partyOrPartyRole.@type	Type of the related party. Possible value for user: - Organization - Individual Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party.- Possible value for `user`: - Company - Department - Possible value for `customer`: Account - Possible value for `consumer`: User Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	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
status	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
title	Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`\).Data type: String

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\": [
      {
        \"role\": \"User\",
        \"partyOrPartyRole\": {
          \"id\": \"c456def03710200044e0bfc8bcbe5d99\",
          \"name\": \"Global Corp\",
          \"@type\": \"Individual\"
        }
      }
    ],
    \"status\": \"active\",
    \"@type\": \"Individual\",
    \"partyOrPartyRole\": {
      \"role\": \"Consumer\",
      \"@type\": \"Party\"
    }
  }" \

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": [
    {
      "role": "User",
      "partyOrPartyRole": {
        "id": "c456def03710200044e0bfc8bcbe5d99",
        "name": "Global Corp",
        "@type": "Individual"
      }
    }
  ],
  "status": "active",
  "@type": "Individual",
  "partyOrPartyRole": {
    "role": "Consumer",
    "@type": "Party"
  },
   "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.

URL format

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

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

Supported request parameters

Name	Description
api\_version	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

Name	Description
None

Name	Description
@type	This value is always `Organization`.Data type: String
contactMedium	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", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ]`
contactMedium.@type	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
contactMedium.city	City of the organization.Data type: String
contactMedium.country	Country of the organization.Data type: String
contactMedium.emailAdress	Email address of the organization contact.Data type: String
contactMedium.locationId	Sys\_id of the location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	The type of contact medium. Possible values: - businessPhone - email - faxPhone - homePhone - mobilePhone - postalAddress Data type: String
contactMedium.phoneNumber	Phone number of the organization contact.Data type: String
contactMedium.postCode	Postcode of the organization.Data type: String
contactMedium.preferred	This value is always `false`.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
externalReference	List of identifiers of the party in an external system.Data type: Array of Objects `"externalReference": [ { "externalIdentifierType": "String", "name": "String" } ]`
externalReference.externalIdentifierType	Type of entity within the external system.Data type: String
externalReference.name	Human-readable name of the external system or reference.Data type: String
href	Relative link to the account record \(URI\).Table: Account \[customer\_account\] Data type: String
id	Sys\_id of the external entity account record.Table: Account \[customer\_account\] Data type: String
legalName	Legal name of the organization.Data type: String
name	Name of the organization.Data type: String
partyCharacteristics	List of characteristics that a party can take on. Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, @type defines the subclass extensible name.Possible value: BooleanCharacteristic IntegerCharacteristic StringArrayCharacteristic StringCharacteristic Data type: String
partyCharacteristics.name	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
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in the table. For example, `Company` or `Account`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Account [customer_account] table, then partyOrPartyRole.role is set to `Account`. Likewise, if the sys_id belongs to the Company [core_company] table, then partyOrPartyRole.role is set to `Company`. Data type: Object `"partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", }`
PartyOrPartyRole.@type	This value is always `party`.Data type: String
PartyOrPartyRole.name	Defines the type of the account or company.Data type: String
PartyOrPartyRole.role	Type of the role.Possible value: - Account - Company Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ]`
relatedParty.partyOrPartyRole	Roles related to this party.Data type: Array of Objects `"partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Value is always `Organization`.Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party. Possible value: - Contact - Other Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	Role played by the related party or party role in the context of the specific entity it's linked to. Possible values: - Contact - Other Data type: String
status	Flag that indicates the status of organization.Valid values: - active: Organization is active. - inactive: Organization is inactive. Data type: Boolean
tradingName	Name that the organization trades under.Data type: String

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.

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

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.

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

Response body parameters (JSON or XML)

Name	Description
@type	This value is always `Organization`.Data type: String
contactMedium	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", "mediumType": "String", "phoneNumber": "String", "postCode": "String", "preferred": "Boolean", "stateOrProvince": "String", "street1": "String", "street2": "String" } ]`
contactMedium.@type	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
contactMedium.city	City of the organization.Data type: String
contactMedium.country	Country of the organization.Data type: String
contactMedium.emailAdress	Email address of the organization contact.Data type: String
contactMedium.locationId	Sys\_id of the location.Table: Location \[cmn\_location\] Data type: String
contactMedium.mediumType	The type of contact medium. Possible values: - businessPhone - email - faxPhone - homePhone - mobilePhone - postalAddress Data type: String
contactMedium.phoneNumber	Phone number of the organization contact.Data type: String
contactMedium.postCode	Postcode of the organization.Data type: String
contactMedium.preferred	This value is always `false`.Data type: Boolean
contactMedium.stateOrProvince	Indicates whether the location is from a state or province.Possible values: - state - province Data type: String
contactMedium.street1	Describes the street.Data type: String
contactMedium.street2	Complementary street description.Data type: String
externalReference	List of identifiers of the party in an external system.Data type: Array of Objects `"externalReference": [ { "externalIdentifierType": "String", "name": "String" } ]`
externalReference.externalIdentifierType	Type of entity within the external system.Data type: String
externalReference.name	Human-readable name of the external system or reference.Data type: String
href	Relative link to the account record \(URI\).Table: Account \[customer\_account\] Data type: String
id	Sys\_id of the external entity account record.Table: Account \[customer\_account\] Data type: String
legalName	Legal name of the organization.Data type: String
name	Name of the organization.Data type: String
partyCharacteristics	List of characteristics that a party can take on. Data type: Array of Objects `"partyCharacteristics": [ { "@type": "String" "name": "String", "value": "String", "valueType": "String" } ]`
partyCharacteristics.@type	When subclassing, @type defines the subclass extensible name.Possible value: BooleanCharacteristic IntegerCharacteristic StringArrayCharacteristic StringCharacteristic Data type: String
partyCharacteristics.name	Name of the party characteristic.Data type: String
partyCharacteristics.value	Value of the party characteristic.Data type: String
partyCharacteristics.valueType	Data type of the characteristic's value.Data type: String
partyOrPartyRole	Roles related to this party are defined where the party is created in the table. For example, `Company` or `Account`.partyOrPartyRole indicates which type of record is retrieved in the operation. If the provided sys_id belongs to the Account [customer_account] table, then partyOrPartyRole.role is set to `Account`. Likewise, if the sys_id belongs to the Company [core_company] table, then partyOrPartyRole.role is set to `Company`. Data type: Object `"partyOrPartyRole": { "@type": "String", "name":"String", "role":"String", }`
PartyOrPartyRole.@type	This value is always `party`.Data type: String
PartyOrPartyRole.name	Defines the type of the account or company.Data type: String
PartyOrPartyRole.role	Type of the role.Possible value: - Account - Company Data type: String
relatedParty	List of parties or party roles related to this party.Data type: Array of Objects `"relatedParty": [ { "partyOrPartyRole": {Object}, "role": "String" } ]`
relatedParty.partyOrPartyRole	Roles related to this party.Data type: Array of Objects `"partyOrPartyRole": [ { "@type": "String", "id": "String", "name": "String", } ]`
relatedParty.partyOrPartyRole.@type	Type of the related party. Value is always `Organization`.Data type: String
relatedParty.partyOrPartyRole.id	Sys\_id of the related party. Possible value: - Contact - Other Data type: String
relatedParty.partyOrPartyRole.name	Name of the related party.Data type: String
relatedParty.role	Role played by the related party or party role in the context of the specific entity it's linked to. Possible values: - Contact - Other Data type: String
status	Flag that indicates the status of organization.Valid values: - active: Organization is active. - inactive: Organization is inactive. Data type: Boolean
tradingName	Name that the organization trades under.Data type: String

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,
      "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": "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",
        "name": "John Doe",
        "@type": "Individual"
      }
    },
    {
      "role": "other",
      "partyOrPartyRole": {
        "id": "776a22ea11f43110f877366201dea6b7",
        "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",
  "partyOrPartyRole": {
    "@type": "Party",
    "name": "Customer",
    "role": "Account"
  }
}'

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,
      "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": "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",
        "name": "John Doe",
        "@type": "Individual"
      }
    },
    {
      "role": "other",
      "partyOrPartyRole": {
        "id": "776a22ea11f43110f877366201dea6b7",
        "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",
  "partyOrPartyRole": {
    "@type": "Party",
    "name": "Customer",
    "role": "Account"
  },
  "createdDate": "2025-06-25T14:32:18.000Z",
  "lastModifiedDate": "2025-06-25T14:32:18.000Z"
}