--- sourceDocument: Australia API Reference sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/api-reference Release : - australia ft:locale : - en-US ft:publication_title : - Australia API Reference ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Party Management Open API # Party Management Open API {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 70 minutes to read The Party Management Open API provides endpoints for managing parties with a relationship to the enterprise, like a consumer, account, or contact. Use this API to create, update, and retrieve data from the Consumer \[csm_consumer\], Account \[customer_account\], and Contact \[customer_contact\] tables. The Party Management Open API is a ServiceNow® implementation of the TM Forum Party Management API REST specification. This implementation is based on the [TMF632 Party Management API Conformance Profile v5.0.0 -- TM Forum](https://www.tmforum.org/resources/reference/tmf632b-party-management-api-conformance-profile-v5-0-0/), June 2025. The Party Management Open API is conformance certified by TM Forum. This API is provided within the sn_tmf_api namespace. The calling user must have the sn_tmf_api.party_integrator role. The Customer Service Base Entities (com.snc.cs_base) plugin is required, particularly for all GET operations. This API can be extended to make customizations around required parameters, request body validation, additional REST operations, and field mappings. Sensitive fields like phone numbers may require special ACL permissions for update or retrieval. ## v2: CTK Compliance and Structural Changes {#tmf-party-management-open-api__section_xrt_fry_ckc} The Party Management Open API has been updated to align with TMF 632 CTK (Core Transaction Kernel) compliance standards. These changes improve interoperability with external telecommunications systems and clarify the structure of party and relationship data. Key changes with v2: 1. Removal of PartyOrPartyRole Object: In previous versions, a `PartyOrPartyRole` object at the root level was used to determine whether a request would create an Account, Consumer, or Contact. This object is no longer supported and has been removed. Use the `@type` field instead. 2. Introduction of @type at Root Level: The `@type` field is now mandatory at the root level of all requests to POST endpoints. This field explicitly declares the type of party object being created: * `@type: "Account"`: Creates or updates an Account record. * `@type: "Consumer"`: Creates or updates a Consumer record. * `@type: "Contact"`: Creates or updates a Contact record. {#tmf-party-management-open-api__ul_nvk_yry_ckc} {#tmf-party-management-open-api__ol_mvk_yry_ckc} The v1 API endpoints continue to support the legacy `PartyOrPartyRole` structure. For new integrations or when upgrading existing integrations, use the v2 endpoints with the updated `@type` structure. Both versions are available during the transition period; however, v1 is deprecated and will be sunset in a future release. ## Migration Guide {#tmf-party-management-open-api__section_ovk_yry_ckc} If you are upgrading from a previous version using `PartyOrPartyRole`: 1. **Remove** any `PartyOrPartyRole` object from your request payload 2. **Add** the `@type` field at the root level with the appropriate value (`Account`, `Consumer`, or `Contact`) 3. **Update** the `relatedParty` object to include the mandatory `@type` field (set to `"User"` for Consumer creation) 4. **Retain** the `role` field in `relatedParty` with value `"User"` {#tmf-party-management-open-api__ol_pvk_yry_ckc} ## Party Management -- DELETE /api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title2} 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 {#partymgmt-DELETE-individual-id__entry__2}{#partymgmt-DELETE-individual-id__version-not_optional-RESTAPI} | 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 | [Table 1. Path parameters] {#partymgmt-DELETE-individual-id__entry__8} | Name | Description | |-|-| | None | | [Table 2. Query parameters] {#partymgmt-DELETE-individual-id__entry__12} | Name | Description | |-|-| | None | | [Table 3. Request body parameters (XML or JSON)] ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-DELETE-individual-id__entry__16}{#partymgmt-DELETE-individual-id__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 4. Request headers] {#partymgmt-DELETE-individual-id__entry__20} | Header | Description | |-|-| | None | | [Table 5. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-DELETE-individual-id__entry__24}{#partymgmt-DELETE-individual-id__entry-200-status-code}{#partymgmt-DELETE-individual-id__entry-400-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | | 400 | Bad Request. A bad request type or malformed request was detected. | [Table 6. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-DELETE-individual-id__entry__30} | 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 {#ariaid-title3} 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 {#partymgmt-GET-individual__entry__2}{#partymgmt-GET-individual__version-not_optional-RESTAPI} | 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 | [Table 7. Path parameters] {#partymgmt-GET-individual__entry__6} | 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 {#partymgmt-GET-individual__ul_cgv_ywm_3hc} 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 | [Table 8. Query parameters] {#partymgmt-GET-individual__entry__16} | Name | Description | |-|-| | None | | [Table 9. Request body parameters (XML or JSON)] ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-individual__entry__20}{#partymgmt-GET-individual__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 10. Request headers] {#partymgmt-GET-individual__entry__24} | 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 {#partymgmt-GET-individual__ul_lwd_rxm_3hc} | | X-Total-Count | For paginated queries, this header specifies the total number of records available on the server. | [Table 11. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-individual__entry__34} | 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 {#partymgmt-GET-individual__ul_dz4_5xm_3hc} | | 404 | Record not found. No records matching the query parameters are found in the table. | [Table 12. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-GET-individual__id_eyq_bh4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-GET-individual__ul_dg2_fny_ckc} Data type: String | | 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 {#partymgmt-GET-individual__ul_l4j_kw3_jhc} 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 {#partymgmt-GET-individual__ul_zvs_1f4_3hc} 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 {#partymgmt-GET-individual__ul_g4d_s24_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 {#partymgmt-GET-individual__ul_bws_1f4_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-GET-individual__ul_qbh_py3_jhc} 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. {#partymgmt-GET-individual__ul_hws_1f4_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [ ] {#partymgmt-GET-individual__id_eyq_bh4_3hc} ### cURL request Retrieves a list of all party management records in the instance. curl"http://instance.servicenow.com/api/v1/sn_tmf_api/party/individual" \ --request GET \ --header "Accept:application/json" \ --user 'user:password' Response body for a Individual Contact party. [ { "id": "34d92aaa11f43110f877366201dea67b", "externalId": "LOC-SF-HQ-2026", "href": "api/sn_tmf_api/party/individual/34d92aaa11f43110f877366201dea67b", "name": "carlos.star", "givenName": "Carlos", "middleName": "", "familyName": "Star", "gender": "", "title": "", "partyCharacteristics": [ { "name": "notification", "value": "Enable", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "preferredLanguage", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "dateFormat", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "timeFormat", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "timeZone", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "vip", "value": false, "valueType": "boolean", "@type": "BooleanCharacteristic" }, { "name": "webServiceAccessOnly", "value": false, "valueType": "boolean", "@type": "BooleanCharacteristic" }, { "name": "source", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "eduStatus", "value": "Faculty", "valueType": "string", "@type": "StringCharacteristic" } ], "contactMedium": [ { "preferred": false, "mediumType": "email", "emailAddress": "carlos.star@example.com", "@type": "EmailContactMedium" }, { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "mobilePhone", "phoneNumber": "", "@type": "MobilePhoneContactMedium" } ], "externalReference": [], "relatedParty": [ { "@type": "Company", "role": "Company" }, { "role": "Department" } ], "status": "Active", "@type": "Individual" } ] Response body for a Individual Consumer party. [ { "id": "168bfc6953a46210132bddeeff7b129f", "href": "api/sn_tmf_api/party/individual/168bfc6953a46210132bddeeff7b129f", "givenName": "yyyg", "middleName": "hhh", "familyName": "bhhhbjhh", "gender": "", "nationality": "", "title": "", "partyCharacteristics": [ { "name": "notes", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "user", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "notification", "value": "Enable", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "preferredLanguage", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "dateFormat", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "timeFormat", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "timeZone", "value": "", "valueType": "string", "@type": "StringCharacteristic" } ], "contactMedium": [ { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "mobilePhone", "phoneNumber": "", "@type": "MobilePhoneContactMedium" }, { "preferred": false, "mediumType": "fax", "phoneNumber": "", "@type": "FaxContactMedium" }, { "preferred": false, "mediumType": "postalAddress", "@type": "GeographicalAddressContactMedium", "city": "ygyg", "locationId": "a39bfc6953a46210132bddeeff7b12b7", "country": "", "postCode": "hh", "stateOrProvince": "gyg", "street1": "hgg", "street2": "" } ], "externalReference": [], "relatedParty": [ { "@type": "User", "role": "User" } ], "status": "Active", "@type": "User" } ] ## Party Management - GET /api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title4} 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 {#partymgmt-GET-individual-id__entry__2}{#partymgmt-GET-individual-id__version-not_optional-RESTAPI} | 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 | [Table 13. Path parameters] {#partymgmt-GET-individual-id__entry__8} | 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 {#partymgmt-GET-individual-id__ul_o1v_ccn_3hc} Data type: String Default: Returns all fields | [Table 14. Query parameters] {#partymgmt-GET-individual-id__entry__12} | Name | Description | |-|-| | None | | [Table 15. Request body parameters (XML or JSON)] ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-individual-id__entry__16}{#partymgmt-GET-individual-id__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 16. Request headers] {#partymgmt-GET-individual-id__entry__20} | Header | Description | |-|-| | None | | [Table 17. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-individual-id__entry__24}{#partymgmt-GET-individual-id__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 18. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-GET-individual-id__table_mh2_hc4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-GET-individual-id__ul_dg2_fny_ckc} Data type: String | | 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 {#partymgmt-GET-individual-id__ul_l4j_kw3_jhc} 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 {#partymgmt-GET-individual-id__ul_zvs_1f4_3hc} 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 {#partymgmt-GET-individual-id__ul_g4d_s24_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 {#partymgmt-GET-individual-id__ul_bws_1f4_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-GET-individual-id__ul_qbh_py3_jhc} 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. {#partymgmt-GET-individual-id__ul_hws_1f4_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [ ] {#partymgmt-GET-individual-id__table_mh2_hc4_3hc} ### cURL request Retrieves a specified record, `12345`, from the table. curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual/12345" \ --request GET \ --header "Accept:application/json" \ --user 'user':'password' \ Response body. { "id": "12345", "externalId": "LOC-SF-HQ-2026", "givenName": "JohnTest6", "middleName": "A.", "familyName": "Doe", "gender": "male", "nationality": "American", "title": "Mr", "contactMedium": [ { "preferred": true, "mediumType": "email", "emailAddress": "john.doe18723@example.com", "@type": "EmailContactMedium" }, { "preferred": false, "mediumType": "mobilePhone", "phoneNumber": "+1-202-555-0198", "@type": "PhoneContactMedium" }, { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "+1-202-555-0198", "@type": "BusinessPhoneContactMedium" }, { "preferred":false, "mediumType":"faxPhone", "phoneNumber":"123456789", "@type":"FaxContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "+1-202-555-0198", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "postalAddress", "@type": "GeographicAddressContactMedium", "locationId":"25ab9e240a0a0bb3009eb9ef8dd0a2c0", "city": "Town", "country": "USA", "postCode": "07960", "stateOrProvince": "New Jersey", "street1": "1820 Harris Houston Road, Charlotte", "street2": "East Tower - 10th Floor" }, { "preferred": false, "mediumType": "postalAddress", "@type": "GeographicAddressContactMedium", "locationId":"25aba17a0a0a0bb3007efd809d6e695c", "city": "Webster", "country": "USA", "postCode": "76022", "stateOrProvince": "TN", "street1": "17077 Texas Avenue, Webster", "street2": "East Tower - 11th Floor" } ], "externalReference": [ { "externalIdentifierType": "facebook", "id": "http://facebook.com/johndoe" } ], "partyCharacteristic": [ { "name": "notes", "value": "notes about the consumer", "valueType": "string", "@type": "string" }, { "name": "dateFormat", "value": "dd-mm-yyyy", "valueType": "string", "@type": "string" }, { "name": "timeformat", "value": "hh.mm.ss (12 hour)", "valueType": "string", "@type": "string" }, { "name": "notification", "value": "Enable", "valueType": "string", "@type": "string" } ], "relatedParty": [ { "@type": "User", "role": "User" } ], "status": "active", "@type": "User" } ## Party Management -- GET /api/ sn_tmf_api/v1/party/organization/{id} {#ariaid-title5} 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 {#partymgmt-GET-organization-id__entry__2}{#partymgmt-GET-organization-id__version-not_optional-RESTAPI} | 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 | [Table 19. Path parameters] {#partymgmt-GET-organization-id__entry__8} | Name | Description | |-|-| | fields | List of fields to return in the response. Invalid fields are ignored. Valid fields: * @type * href * id * legalName * name * status * tradingName {#partymgmt-GET-organization-id__ul_irf_5mn_3hc} 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 | [Table 20. Query parameters] {#partymgmt-GET-organization-id__entry__18} | Name | Description | |-|-| | None | | [Table 21. Request body parameters (XML or JSON)] ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-organization-id__entry__22}{#partymgmt-GET-organization-id__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 22. Request headers] {#partymgmt-GET-organization-id__entry__26} | Header | Description | |-|-| | None | | [Table 23. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-organization-id__entry__30}{#partymgmt-GET-organization-id__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 24. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-GET-organization-id__section_r5x_5k4_3hc} {#partymgmt-GET-organization-id__table_edn_qnn_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-GET-organization-id__ul_pfh_gny_ckc} 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", "contactType": "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 {#partymgmt-GET-organization-id__ul_vxy_4jn_3hc} 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 {#partymgmt-GET-organization-id__ul_lq4_fjn_3hc} 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 {#partymgmt-GET-organization-id__ul_swk_tl4_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | createdDate | Timestamp when the organization record was created (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 | | lastModifiedDate | Timestamp when the organization record was last modified (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | 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 {#partymgmt-GET-organization-id__ul_tyq_y3n_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-GET-organization-id__ul_f1w_wmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-GET-organization-id__ul_ldr_k3n_3hc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [ ] {#partymgmt-GET-organization-id__table_edn_qnn_3hc} ### cURL request The following GET call returns fields for the specified party management organization record with sys_id, 12345. curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization/12345" \ --request GET \ --header "Accept:application/json" \ --user 'user':'password' \ Response body. { "id": "2154376", "name": "Advances Super Computing", "href": "api/sn_tmf_api/party/organization/2154376", "externalId": "LOC-SF-HQ-2026", "legalName": "Hello", "tradingName": "World", "contactMedium": [ { "preferred": "false", "mediumType": "email", "@type": "EmailContactMedium", "emailAddress": "user@servicenow.com" }, { "preferred": "false", "mediumType": "phone", "@type": "PhoneContactMedium", "phone": "(555) 555-5555" }, { "preferred": "false", "mediumType": "faxPhone", "@type": "FaxPhoneContactMedium", "fax_phone": "" } ], "externalReference": [ { "externalIdentifierType": "Facebook", "name": "facebook.com" }, { "externalIdentifierType": "Twitter", "name": "twitter.com" } ], "partyCharacteristic": [ { "name": "notes", "value": "efdxcjkn ", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "registrationCode", "value": "23456789", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "accountCode", "value": "####30", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "identificationNumber", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "taxId", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "industry", "value": "", "valueType": "choice", "@type": "StringCharacteristic" }, { "name": "numEmployees", "value": "", "valueType": "integer", "@type": "IntergerCharacteristic" }, { "name": "rankTier", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "publiclyTraded", "value": "false", "valueType": "boolean", "@type": "BooleanCharacteristic" }, { "name": "stockSymbol", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "stockPrice", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "vendorType", "value": "Services, Applications", "valueType": "list", "@type": "StringArrayCharacteristic" }, { "name": "marketCap", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "profits", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "revenuePerYear", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "website", "value": "sdfgh.com", "valueType": "string", "@type": "StringCharacteristic" } ], "relatedParty": [ { "type": "User", "role": "primary" }, { "type": "User", "role": "other" }, { "type": "User", "role": "other" } ], "organizationChildRelationship": [ { "relationshipType": "partner_account", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Startech svcs", "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674", "@type": "Organization" } }, { "relationshipType": "New type", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Startech svcs", "href": "api/sn_tmf_api/party/organization/9e2fd2ee11b43110f877366201dea674", "@type": "Organization" } }, { "relationshipType": "child", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Startech svcs", "href": "api/sn_tmf_api/party/organization/null", "@type": "Organization" } } ], "organizationParentRelationship": { "relationshipType": "parent", "organization": { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "href": "undefinedffc68911c35420105252716b7d40dd55", "@type": "Organization" } }, "status": "inActive", "@type": "User" } ## Party Management - GET /api/sn_tmf_api/v1/party/organization {#ariaid-title6} 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 {#partymgmt-GET-organization__entry__2}{#partymgmt-GET-organization__version-not_optional-RESTAPI} | 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 | [Table 25. Path parameters] {#partymgmt-GET-organization__entry__6} | Name | Description | |-|-| | fields | List of fields to return in the response. Invalid fields are ignored. Valid fields: * @type * href * id * legalName * name * status * tradingName {#partymgmt-GET-organization__ul_tpl_5hn_3hc} 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 | [Table 26. Query parameters] {#partymgmt-GET-organization__id_avm_mj4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-GET-organization__ul_atg_1ny_ckc} Data type: String | | 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 {#partymgmt-GET-organization__ul_j3y_jw3_jhc} 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 {#partymgmt-GET-organization__ul_mjg_sj4_3hc} 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 {#partymgmt-GET-organization__ul_ojg_sj4_3hc} 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 {#partymgmt-GET-organization__ul_bff_czm_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-GET-organization__ul_efv_tmy_ckc} 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. {#partymgmt-GET-organization__ul_z2z_4ym_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [Table 27. Request body parameters (XML or JSON)] {#partymgmt-GET-organization__id_avm_mj4_3hc} ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-organization__entry__80}{#partymgmt-GET-organization__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 28. Request headers] {#partymgmt-GET-organization__entry__84} | Header | Description | |-|-| | None | | [Table 29. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-GET-organization__entry__88}{#partymgmt-GET-organization__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 30. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-GET-organization__section_r5x_5k4_3hc} {#partymgmt-GET-organization__table_edn_qnn_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-GET-organization__ul_pfh_gny_ckc} 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", "contactType": "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 {#partymgmt-GET-organization__ul_vxy_4jn_3hc} 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 {#partymgmt-GET-organization__ul_lq4_fjn_3hc} 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 {#partymgmt-GET-organization__ul_swk_tl4_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | createdDate | Timestamp when the organization record was created (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 | | lastModifiedDate | Timestamp when the organization record was last modified (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | 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 {#partymgmt-GET-organization__ul_tyq_y3n_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-GET-organization__ul_f1w_wmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-GET-organization__ul_ldr_k3n_3hc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [ ] {#partymgmt-GET-organization__table_edn_qnn_3hc} ### cURL request This returns all organization records related to the enterprise. curl"http://instance.servicenow.com/api/sn_tmf_api/v1/party/organization" \ --request GET \ --header "Accept:application/json" \ --user 'user':'password' Response body. [ { "id": "0bd6717c184da610f87765359bc696d3", "name": "SERVICENOW 144", "href": "api/sn_tmf_api/party/organization0bd6717c184da610f87765359bc696d3", "externalId": "LOC-SF-HQ-2026", "legalName": "", "tradingName": "", "contactMedium": [ { "preferred": "false", "mediumType": "email", "@type": "EmailContactMedium", "emailAddress": "user@email.com" }, { "preferred": "false", "mediumType": "phone", "@type": "PhoneContactMedium", "phone": "+1-555-555-5555" }, { "preferred": "false", "mediumType": "faxPhone", "@type": "FaxPhoneContactMedium", "fax_phone": "" } ], "externalReference": [ { "externalIdentifierType": "Instagram", "name": "" } ], "partyCharacteristic": [ { "name": "notes", "value": "Testing for update the notes", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "registrationCode", "value": "111122112211", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "accountCode", "value": "accountcode1", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "identificationNumber", "value": "", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "taxId", "value": "CTNUM1000123", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "industry", "value": "technology_services", "valueType": "choice", "@type": "StringCharacteristic" }, { "name": "numEmployees", "value": "", "valueType": "integer", "@type": "IntergerCharacteristic" }, { "name": "rankTier", "value": "rankTier", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "publiclyTraded", "value": "false", "valueType": "boolean", "@type": "BooleanCharacteristic" }, { "name": "stockSymbol", "value": "Market", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "stockPrice", "value": "1000", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "vendorType", "value": "Hardware", "valueType": "list", "@type": "StringArrayCharacteristic" }, { "name": "marketCap", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "profits", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "revenuePerYear", "value": "0", "valueType": "string", "@type": "StringCharacteristic" }, { "name": "website", "value": "", "valueType": "string", "@type": "StringCharacteristic" } ], "relatedParty": [], "organizationChildRelationship": [ { "relationshipType": "Partner Account", "organization": { "id": "396b47201841a610f87765359bc696cf", "name": "child", "href": "api/sn_tmf_api/party/organization396b47201841a610f87765359bc696cf", "@type": "Organization" } } ], "organizationParentRelationship": { "relationshipType": "parent", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Startech svcs", "href": "api/sn_tmf_api/party/organization9e2fd2ee11b43110f877366201dea674", "@type": "Organization" } }, "@type": "User" } ] ## Party Management -- PATCH /api/sn_tmf_api/v1/party/individual/{id} {#ariaid-title7} 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 {#partymgmt-PATCH-individual-id__entry__2}{#partymgmt-PATCH-individual-id__version-not_optional-RESTAPI} | 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 | [Table 31. Path parameters] {#partymgmt-PATCH-individual-id__entry__8} | Name | Description | |-|-| | None | | [Table 32. Query parameters] {#partymgmt-PATCH-individual-id__id_zhv_km4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-PATCH-individual-id__ul_atg_1ny_ckc} Data type: String | | 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 {#partymgmt-PATCH-individual-id__ul_j3y_jw3_jhc} 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 {#partymgmt-PATCH-individual-id__ul_mjg_sj4_3hc} 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 {#partymgmt-PATCH-individual-id__ul_ojg_sj4_3hc} 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 {#partymgmt-PATCH-individual-id__ul_bff_czm_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-PATCH-individual-id__ul_efv_tmy_ckc} 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. {#partymgmt-PATCH-individual-id__ul_z2z_4ym_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [Table 33. Request body parameters (XML or JSON)] {#partymgmt-PATCH-individual-id__id_zhv_km4_3hc} ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-PATCH-individual-id__entry__76}{#partymgmt-PATCH-individual-id__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 34. Request headers] {#partymgmt-PATCH-individual-id__entry__80} | Header | Description | |-|-| | None | | [Table 35. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-PATCH-individual-id__entry__84}{#partymgmt-PATCH-individual-id__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 36. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-PATCH-individual-id__id_t1b_mm4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-PATCH-individual-id__ul_dg2_fny_ckc} Data type: String | | 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 {#partymgmt-PATCH-individual-id__ul_l4j_kw3_jhc} 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 {#partymgmt-PATCH-individual-id__ul_zvs_1f4_3hc} 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 {#partymgmt-PATCH-individual-id__ul_g4d_s24_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 {#partymgmt-PATCH-individual-id__ul_bws_1f4_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-PATCH-individual-id__ul_qbh_py3_jhc} 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. {#partymgmt-PATCH-individual-id__ul_hws_1f4_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [ ] {#partymgmt-PATCH-individual-id__id_t1b_mm4_3hc} ### cURL request Updates an existing individual party record with sys_id, 12345, in the Consumer \[csm_consumer\] or Contact \[customer_contact\] table without replacing the entire resource. curl "http://localhost:8080/api/sn_tmf_api/v1/party/Individual/12345" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user 'user':'password' --data "{ \"name\": \"John.Doe\", \"givenName\": \"John\", \"middleName\": \"A.\", \"familyName\": \"Doe\", \"gender\": \"male\", \"nationality\": \"American\", \"title\": \"Mr\", \"contactMedium\": [ { \"preferred\": true, \"mediumType\": \"email\", \"emailAddress\": \"john.doe@gmail.com\", \"@type\": \"EmailContactMedium\" }, { \"preferred\": false, \"mediumType\": \"businessPhone\", \"phoneNumber\": \"+1-202-555-0188\", \"@type\": \"PhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"homePhone\", \"phoneNumber\": \"+1-202-555-0198\", \"@type\": \"HomePhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"postalAddress\", \"@type\": \"GeographicAddressContactMedium\", \"locationId\":\"92656927259338967\", \"city\": \"Morristown\", \"country\": \"USA\", \"postCode\": \"07960\", \"stateOrProvince\": \"New Jersey\", \"street1\": \"240 Headquarters Plazza\", \"street2\": \"East Tower - 10th Floor\" } ], \"partyCharacteristic\": [ { \"name\": \"notification\", \"value\": \"enable\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"dateFormat\", \"value\": \"MM/DD/YYYY\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"timeFormat\", \"value\": \"12-hour\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"timeZone\", \"value\": \"EST\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"vip\", \"value\": true, \"valueType\": \"boolean\", \"@type\": \"string\" }, { \"name\": \"webServiceAccessOnly\", \"value\": false, \"valueType\": \"boolean\", \"@type\": \"string\" }, { \"name\": \"source\", \"value\": \"Third-party system\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"eduStatus\", \"value\": \"Graduated\", \"valueType\": \"string\", \"@type\": \"string\" } ], \"relatedParty\": [ { \"@type\": \"User\", \"role\": \"Company\" }, { \"@type\": \"User\" \"role\": \"Department\" } ], \"status\": \"active\", \"@type\": \"User\" }" \ Response body. { "name": "Jane Smith", "givenName": "Jane", "middleName": "B.", "familyName": "Smith", "gender": "female", "nationality": "American", "title": "Ms", "contactMedium": [ { "preferred": true, "mediumType": "email", "emailAddress": "jane.smith@example.com", "@type": "EmailContactMedium" }, { "preferred": false, "mediumType": "mobilePhone", "phoneNumber": "+1-416-555-1234", "@type": "PhoneContactMedium" }, { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "+1-416-555-5678", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "mediumType": "fax", "fax": "987654321", "@type": "FaxContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "+1-416-555-4321", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "postalAddress", "@type": "GeographicAddressContactMedium", "locationId": "03e588a17be062105e0d5494548cb68c", "city": "Toronto", "country": "Canada", "postCode": "M5H 2N2", "stateOrProvince": "Ontario", "street1": "123 Queen St W", "street2": "Suite 1500" } ], "externalReference": [ { "externalIdentifierType": "linkedin", "id": "http://linkedin.com/in/janesmith" } ], "partyCharacteristic": [ { "name": "notes", "value": "General consumer information.", "valueType": "string", "@type": "string" }, { "name": "userName", "value": "janesmith", "valueType": "string", "@type": "string" }, { "name": "vip", "value": false, "valueType": "boolean", "@type": "string" }, { "name": "source", "value": "CRM System", "valueType": "string", "@type": "string" }, { "name": "dateFormat", "value": "yyyy-mm-dd", "valueType": "string", "@type": "string" }, { "name": "timeformat", "value": "HH:mm:ss (24 hour)", "valueType": "string", "@type": "string" }, { "name": "notification", "value": "Disabled", "valueType": "string", "@type": "string" } ], "relatedParty": [ { "@type": "User", "role": "User" } ], "status": "active", "@type": "User", "warning": [ "relatedParty[0] is incorrect. User does not exist" ] } ## Party Management - PATCH /api/sn_tmf_api/v1/party/organization/{id} {#ariaid-title8} 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 {#partymgmt-PATCH-organization-id__entry__2}{#partymgmt-PATCH-organization-id__version-not_optional-RESTAPI} | 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 | [Table 37. Path parameters] {#partymgmt-PATCH-organization-id__entry__6} | Name | Description | |-|-| | None | | [Table 38. Query parameters] {#partymgmt-PATCH-organization-id__id_czh_nnj_jhc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-PATCH-organization-id__ul_hfv_fny_ckc} 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", "contactType": "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 {#partymgmt-PATCH-organization-id__ul_vwf_1nj_jhc} Data type: String | | contactMedium.city | City of the organization. Data type: String | | contactMedium.contactType | The type of contact medium. Possible values: * `businessPhone` * `email` * `faxPhone` * `homePhone` * `mobilePhone` * `postalAddress` {#partymgmt-PATCH-organization-id__ul_wwf_1nj_jhc} 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.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` {#partymgmt-PATCH-organization-id__ul_xwf_1nj_jhc} 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 | | organizationChildRelationship | List of child organization relationships, such as subsidiary, partner, or branch organizations. Data type: Array of Objects "organizationChildRelationship": [ { "relationshipType": "String", "organization": {Object} } ] | | organizationChildRelationship.organization | Child organization object containing identity and details. Data type: Object "organization": { "id": "String", "name": "String", "@type": "String" } | | organizationChildRelationship.organization.@type | Type of the organization object. Value is always `Organization`. Data type: String | | organizationChildRelationship.organization.id | Sys_id of the child organization record. Table: Account \[customer_account\] or Organization \[core_company\] Data type: String | | organizationChildRelationship.organization.name | Display name of the child organization. Data type: String | | organizationChildRelationship.relationshipType | Type of relationship between parent and child organization. Data type: String Accepted values: * `partneraccount` * `distributor` * `subsidiary` * `branch` * `reseller` {#partymgmt-PATCH-organization-id__ul_trn_krf_dkc} | | organizationParentRelationship | Parent organization relationship. Data type: Object "organizationParentRelationship": { "relationshipType": "String", "organization": {Object} } | | organizationParentRelationship.organization | Parent organization object containing identity and details. Data type: Object "organization": { "id": "String", "name": "String", "@type": "String" } | | organizationParentRelationship.organization.@type | Type of the organization object. Value is always `Organization`. Data type: String | | organizationParentRelationship.organization.id | Sys_id of the parent organization record. Table: Account \[customer_account\] or Organization \[core_company\] Data type: String | | organizationParentRelationship.organization.name | Display name of the parent organization. Data type: String | | organizationParentRelationship.relationshipType | Type of relationship between this organization and its parent. Accepted values: * `Account` * `Company` * `HoldingCompany` * `ParentAccount` {#partymgmt-PATCH-organization-id__ul_ljc_bsf_dkc} 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 {#partymgmt-PATCH-organization-id__ul_ywf_1nj_jhc} 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 {#partymgmt-PATCH-organization-id__ul_hkz_g2c_sjc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-PATCH-organization-id__ul_ccy_vmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-PATCH-organization-id__ul_cxf_1nj_jhc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [Table 39. Request body parameters (XML or JSON)] {#partymgmt-PATCH-organization-id__id_czh_nnj_jhc} ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-PATCH-organization-id__entry__98}{#partymgmt-PATCH-organization-id__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 40. Request headers] {#partymgmt-PATCH-organization-id__entry__102} | Header | Description | |-|-| | None | | [Table 41. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-PATCH-organization-id__entry__106}{#partymgmt-PATCH-organization-id__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 42. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-PATCH-organization-id__id_xzr_pm4_3hc} {#partymgmt-PATCH-organization-id__table_edn_qnn_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-PATCH-organization-id__ul_pfh_gny_ckc} 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", "contactType": "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 {#partymgmt-PATCH-organization-id__ul_vxy_4jn_3hc} 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 {#partymgmt-PATCH-organization-id__ul_lq4_fjn_3hc} 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 {#partymgmt-PATCH-organization-id__ul_swk_tl4_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | createdDate | Timestamp when the organization record was created (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 | | lastModifiedDate | Timestamp when the organization record was last modified (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | 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 {#partymgmt-PATCH-organization-id__ul_tyq_y3n_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-PATCH-organization-id__ul_f1w_wmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-PATCH-organization-id__ul_ldr_k3n_3hc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [ ] {#partymgmt-PATCH-organization-id__table_edn_qnn_3hc} ### cURL request This returns specified fields for the party management organization records. curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \ --request PATCH\ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user 'user':'password' \ --data "{ \"name\": \"SERVICENOW 144\", \"legalName\": \"Acme Corp Ltd.\", \"tradingName\": \"Acme Inc.\", \"contactMedium\": [ { \"preferred\": true, \"mediumType\": \"email\", \"emailAddress\": \"athammhd@email.com\", \"@type\": \"EmailContactMedium\" }, { \"preferred\": false, \"mediumType\": \"phone\", \"phoneNumber\": \"+1-202-555-0198\", \"@type\": \"PhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"businessPhone\", \"phoneNumber\": \"+1-202-555-0198\", \"@type\": \"BusinessPhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"homePhone\", \"phoneNumber\": \"+1-202-555-0198\", \"@type\": \"HomePhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"postalAddress\", \"validFor\": { \"startDateTime\": \"2017-03-15T07:49:25.246Z\" }, \"@type\": \"GeographicAddressContactMedium\", \"city\": \"chennai\", \"country\": \"INDIA\", \"postCode\": \"608001\", \"stateOrProvince\": \"tamil nadu\", \"street1\": \"samcon street\", \"street2\": \"adyar,chennai\" } ], \"externalReference\": [ { \"externalIdentifierType\": \"Instagram\", \"id\": \"Instagram\" } ], \"partyCharacteristic\": [ { \"name\": \"notes\", \"value\": \"Testing for update the notes\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"customer\", \"value\": \"true\", \"valueType\": \"boolean\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"registrationCode\", \"value\": \"001\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"vendorType\", \"value\": [\"Hardware\"], \"valueType\": \"array\", \"@type\": \"StringArrayCharacteristic\" }, { \"name\": \"industry\", \"value\": \"technology_services\", \"valueType\": \"choice\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"taxId\", \"value\": \"CTNUM1000123\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"numEmployees\", \"value\": \"EMP1000\", \"valueType\": \"integer\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"rankTier\", \"value\": \"rankTier\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"publiclyTraded\", \"value\": \"false\", \"valueType\": \"boolean\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"stockSymbol\", \"value\": \"Market\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"stockPrice\", \"value\": \"1000\", \"valueType\": \"string\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"vendor\", \"value\": \"false\", \"valueType\": \"boolean\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"manufacturer\", \"value\": \"false\", \"valueType\": \"boolean\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"marketCap\", \"value\": \"0\", \"valueType\": \"currency\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"profits\", \"value\": \"0\", \"valueType\": \"currency\", \"@type\": \"StringCharacteristics\" }, { \"name\": \"revenuePerYear\", \"value\": \"0\", \"valueType\": \"currency\", \"@type\": \"StringCharacteristics\" } ], \"relatedParty\": [ { \"@type\": \"User\", \"role\": \"primaryContact\" }, { \"role\": \"other\" } ], \"organizationChildRelationship\": [ { \"relationshipType\": \"partneraccount\", \"organization\": { \"id\": \"0fef075b2fe06a10b79db3bf42faf31a\", \"name\": \"mhd\", \"@type\": \"Organization\" } } ], \"organizationParentRelationship\": { \"relationshipType\": \"Account\", \"organization\": { \"id\": \"9e2fd2ee11b43110f877366201dea674\", \"name\": \"Global Holdings Ltd.\", \"@type\": \"Organization\" } }, \"status\": \"active\", \"@type\": \"User\" }" \ Response body. { "name": "SERVICENOW 144", "legalName": "Acme Corp Ltd.", "tradingName": "Acme Inc.", "contactMedium": [ { "preferred": true, "mediumType": "email", "emailAddress": "athammhd@email.com", "@type": "EmailContactMedium" }, { "preferred": false, "mediumType": "phone", "phoneNumber": "+1-202-555-0198", "@type": "PhoneContactMedium" }, { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "+1-202-555-0198", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "+1-202-555-0198", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "postalAddress", "validFor": { "startDateTime": "2017-03-15T07:49:25.246Z" }, "@type": "GeographicAddressContactMedium", "city": "chennai", "country": "INDIA", "postCode": "608001", "stateOrProvince": "tamil nadu", "street1": "samcon street", "street2": "adyar,chennai" } ], "externalReference": [ { "externalIdentifierType": "Instagram", "id": "Instagram" } ], "partyCharacteristic": [ { "name": "notes", "value": "Testing for update the notes", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "customer", "value": "true", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "registrationCode", "value": "001", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendorType", "value": ["Hardware"], "valueType": "array", "@type": "StringArrayCharacteristic" }, { "name": "industry", "value": "technology_services", "valueType": "choice", "@type": "StringCharacteristics" }, { "name": "taxId", "value": "CTNUM1000123", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "numEmployees", "value": "EMP1000", "valueType": "integer", "@type": "StringCharacteristics" }, { "name": "rankTier", "value": "rankTier", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "publiclyTraded", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "stockSymbol", "value": "Market", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "stockPrice", "value": "1000", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendor", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "manufacturer", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "marketCap", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "profits", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "revenuePerYear", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" } ], "relatedParty": [ { "@type": "User", "role": "primaryContact", }, { "role": "other" } ], "organizationChildRelationship": [ { "relationshipType": "partneraccount", "organization": { "id": "0fef075b2fe06a10b79db3bf42faf31a", "name": "mhd", "@type": "Organization" } } ], "organizationParentRelationship": { "relationshipType": "Account", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Global Holdings Ltd.", "@type": "Organization" } }, "status": "active", "@type": "User", } ## Party Management - POST /api/sn_tmf_api/v1/party/individual {#ariaid-title9} 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 {#partymgmt-POST-individual__entry__2}{#partymgmt-POST-individual__version-not_optional-RESTAPI} | 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 | [Table 43. Path parameters] {#partymgmt-POST-individual__entry__6} | Name | Description | |-|-| | None | | [Table 44. Query parameters] {#partymgmt-POST-individual__id_tzm_xm4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-POST-individual__ul_atg_1ny_ckc} Data type: String | | 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 {#partymgmt-POST-individual__ul_j3y_jw3_jhc} 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 {#partymgmt-POST-individual__ul_mjg_sj4_3hc} 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 {#partymgmt-POST-individual__ul_ojg_sj4_3hc} 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 {#partymgmt-POST-individual__ul_bff_czm_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-POST-individual__ul_efv_tmy_ckc} 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. {#partymgmt-POST-individual__ul_z2z_4ym_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [Table 45. Request body parameters (XML or JSON)] {#partymgmt-POST-individual__id_tzm_xm4_3hc} ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-POST-individual__entry__74}{#partymgmt-POST-individual__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 46. Request headers] {#partymgmt-POST-individual__entry__78} | Header | Description | |-|-| | None | | [Table 47. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-POST-individual__entry__82}{#partymgmt-POST-individual__entry-200-status-code} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. | [Table 48. Status codes] ### Response body parameters (JSON or XML) {#partymgmt-POST-individual__id_vql_zm4_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-POST-individual__ul_dg2_fny_ckc} Data type: String | | 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 {#partymgmt-POST-individual__ul_l4j_kw3_jhc} 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 {#partymgmt-POST-individual__ul_zvs_1f4_3hc} 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 {#partymgmt-POST-individual__ul_g4d_s24_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 {#partymgmt-POST-individual__ul_bws_1f4_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-POST-individual__ul_qbh_py3_jhc} 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. {#partymgmt-POST-individual__ul_hws_1f4_3hc} Data type: Boolean | | title | Prefix or title of the individual. For example, `Dr.`, `Mr.`, `Ms.`). Data type: String | [ ] {#partymgmt-POST-individual__id_vql_zm4_3hc} ### cURL request This returns specified fields for the party management individual records. curl "http://instance.servicenow.com/api/sn_tmf_api/v1/party/individual" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user 'user':'password' --data "{ \"id\": \"98765\", \"name\": \"Jane Smith\", \"givenName\": \"Jane\", \"middleName\": \"B.\", \"familyName\": \"Smith\", \"gender\": \"female\", \"nationality\": \"American\", \"title\": \"Ms\", \"contactMedium\": [ { \"preferred\": true, \"mediumType\": \"email\", \"emailAddress\": \"jane.smith@example.com\", \"@type\": \"EmailContactMedium\" }, { \"preferred\": false, \"mediumType\": \"mobilePhone\", \"phoneNumber\": \"+1-416-555-1234\", \"@type\": \"PhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"businessPhone\", \"phoneNumber\": \"+1-416-555-5678\", \"@type\": \"BusinessPhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"fax\", \"fax\": \"987654321\", \"@type\": \"FaxContactMedium\" }, { \"preferred\": false, \"mediumType\": \"homePhone\", \"phoneNumber\": \"+1-416-555-4321\", \"@type\": \"HomePhoneContactMedium\" }, { \"preferred\": false, \"mediumType\": \"postalAddress\", \"@type\": \"GeographicAddressContactMedium\", \"locationId\": \"12345678901234567\", \"city\": \"Toronto\", \"country\": \"Canada\", \"postCode\": \"M5H 2N2\", \"stateOrProvince\": \"Ontario\", \"street1\": \"123 Queen St W\", \"street2\": \"Suite 1500\" } ], \"externalReference\": [ { \"externalIdentifierType\": \"linkedin\", \"id\": \"http://linkedin.com/in/janesmith\" } ], \"partyCharacteristic\": [ { \"name\": \"notes\", \"value\": \"General consumer information.\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"userName\", \"value\": \"janesmith\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"vip\", \"value\": false, \"valueType\": \"boolean\", \"@type\": \"string\" }, { \"name\": \"source\", \"value\": \"CRM System\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"dateFormat\", \"value\": \"yyyy-mm-dd\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"timeformat\", \"value\": \"HH:mm:ss (24 hour)\", \"valueType\": \"string\", \"@type\": \"string\" }, { \"name\": \"notification\", \"value\": \"Disabled\", \"valueType\": \"string\", \"@type\": \"string\" } ], \"relatedParty\": [ { \"@type\": \"User\" \"role\": \"User\" } ], \"status\": \"active\", \"@type\": \"User\", }" \ Response body. { "id": "83e588a17b6062105e0d5494548cb65d", "href": "api/sn_tmf_api/party/individual/83e588a17b6062105e0d5494548cb65d", "name": "Jane Smith", "givenName": "Jane", "middleName": "B.", "familyName": "Smith", "gender": "female", "nationality": "American", "title": "Ms", "contactMedium": [ { "preferred": true, "mediumType": "email", "emailAddress": "jane.smith@example.com", "@type": "EmailContactMedium" }, { "preferred": false, "mediumType": "mobilePhone", "phoneNumber": "+1-416-555-1234", "@type": "PhoneContactMedium" }, { "preferred": false, "mediumType": "businessPhone", "phoneNumber": "+1-416-555-5678", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "mediumType": "fax", "fax": "987654321", "@type": "FaxContactMedium" }, { "preferred": false, "mediumType": "homePhone", "phoneNumber": "+1-416-555-4321", "@type": "HomePhoneContactMedium" }, { "preferred": false, "mediumType": "postalAddress", "@type": "GeographicAddressContactMedium", "locationId": "03e588a17be062105e0d5494548cb68c", "city": "Toronto", "country": "Canada", "postCode": "M5H 2N2", "stateOrProvince": "Ontario", "street1": "123 Queen St W", "street2": "Suite 1500" } ], "externalReference": [ { "externalIdentifierType": "linkedin", "id": "http://linkedin.com/in/janesmith" } ], "partyCharacteristic": [ { "name": "notes", "value": "General consumer information.", "valueType": "string", "@type": "string" }, { "name": "userName", "value": "janesmith", "valueType": "string", "@type": "string" }, { "name": "vip", "value": false, "valueType": "boolean", "@type": "string" }, { "name": "source", "value": "CRM System", "valueType": "string", "@type": "string" }, { "name": "dateFormat", "value": "yyyy-mm-dd", "valueType": "string", "@type": "string" }, { "name": "timeformat", "value": "HH:mm:ss (24 hour)", "valueType": "string", "@type": "string" }, { "name": "notification", "value": "Disabled", "valueType": "string", "@type": "string" } ], "relatedParty": { "@type": "User", "role": "User" } }, "status": "active", "@type": "User", "warning": [ "relatedParty[0] is incorrect. User does not exist" ] } ## Party Management - POST /api/sn_tmf_api/v1/party/organization {#ariaid-title10} Creates a new party organization record in the Account \[customer_account\] tables. You can also create and associate Contact and Location records inline during organization creation, eliminating the need for separate POST operations. ### Automatic Location Creation with contactMedium {#partymgmt-POST-organization__section_f3z_z5f_dkc} When you include address information in the contactMedium field (with @type set to `GeographicAddressContactMedium`), the system automatically handles location creation and association based on what you provide: 1. If you supply a valid locationId, the system links the existing location record to the organization you are creating. 2. If you provide address attributes (street, city, country, postCode, stateOrProvince) along with an invalid or non-existent locationId, the system automatically creates a new location record with those attributes and associates it to the organization. 3. If you provide address attributes without specifying a locationId at all, the system creates a new location record and associates it to the organization. {#partymgmt-POST-organization__ol_g3z_z5f_dkc} Note: Location creation requires no mandatory fields. You can provide any combination of address attributes (street1, street2, city, state, postCode, country) based on your needs. If you omit all address attributes from the contactMedium section, no location record is created or linked to the organization. ### Inline Contact Creation with relatedParty {#partymgmt-POST-organization__section_jxx_z5f_dkc} When you include contact attributes in the relatedParty field without providing a contact ID, the system automatically creates a new contact record and associates it to the organization you are creating. This eliminates the need for a separate POST request to create the contact first. You can include the following contact information directly in the relatedParty.partyOrPartyRole object. Mandatory attributes for inline contact creation: * familyName (or lastName) * email {#partymgmt-POST-organization__ul_kxx_z5f_dkc} Optional attributes: * givenName * middleName * gender * title * nationality * contactMedium (to include phone, address, or other contact details) {#partymgmt-POST-organization__ul_lxx_z5f_dkc} Example: Creating a contact inline without a pre-existing ID. { "relatedParty": [ { "role": "primaryContact", "partyOrPartyRole": { "givenName": "John", "familyName": "Doe", "email": "john.doe@example.com", "@type": "Individual" } } ] } Legacy approach: Linking an existing contact by ID. If you already have a contact record, you can link it by providing its sys_id instead: { "relatedParty": [ { "role": "primaryContact", "partyOrPartyRole": { "id": "existing_contact_sys_id", "name": "John Doe", "@type": "Individual" } } ] } Both approaches are supported. The system automatically determines whether to create a new contact or link an existing one based on whether the partyOrPartyRole includes an id field. ### URL format Versioned URL: /api/sn_tmf_api/v1/party/organization Default URL: /api/sn_tmf_api/v1/party/organization ### Supported request parameters {#partymgmt-POST-organization__entry__2}{#partymgmt-POST-organization__version-not_optional-RESTAPI} | 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 | [Table 49. Path parameters] {#partymgmt-POST-organization__entry__6} | Name | Description | |-|-| | None | | [Table 50. Query parameters] {#partymgmt-POST-organization__id_gby_knj_jhc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-POST-organization__ul_hfv_fny_ckc} 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", "contactType": "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 {#partymgmt-POST-organization__ul_vwf_1nj_jhc} Data type: String | | contactMedium.city | City of the organization. Data type: String | | contactMedium.contactType | The type of contact medium. Possible values: * `businessPhone` * `email` * `faxPhone` * `homePhone` * `mobilePhone` * `postalAddress` {#partymgmt-POST-organization__ul_wwf_1nj_jhc} 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.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` {#partymgmt-POST-organization__ul_xwf_1nj_jhc} 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 | | organizationChildRelationship | List of child organization relationships, such as subsidiary, partner, or branch organizations. Data type: Array of Objects "organizationChildRelationship": [ { "relationshipType": "String", "organization": {Object} } ] | | organizationChildRelationship.organization | Child organization object containing identity and details. Data type: Object "organization": { "id": "String", "name": "String", "@type": "String" } | | organizationChildRelationship.organization.@type | Type of the organization object. Value is always `Organization`. Data type: String | | organizationChildRelationship.organization.id | Sys_id of the child organization record. Table: Account \[customer_account\] or Organization \[core_company\] Data type: String | | organizationChildRelationship.organization.name | Display name of the child organization. Data type: String | | organizationChildRelationship.relationshipType | Type of relationship between parent and child organization. Data type: String Accepted values: * `partneraccount` * `distributor` * `subsidiary` * `branch` * `reseller` {#partymgmt-POST-organization__ul_trn_krf_dkc} | | organizationParentRelationship | Parent organization relationship. Data type: Object "organizationParentRelationship": { "relationshipType": "String", "organization": {Object} } | | organizationParentRelationship.organization | Parent organization object containing identity and details. Data type: Object "organization": { "id": "String", "name": "String", "@type": "String" } | | organizationParentRelationship.organization.@type | Type of the organization object. Value is always `Organization`. Data type: String | | organizationParentRelationship.organization.id | Sys_id of the parent organization record. Table: Account \[customer_account\] or Organization \[core_company\] Data type: String | | organizationParentRelationship.organization.name | Display name of the parent organization. Data type: String | | organizationParentRelationship.relationshipType | Type of relationship between this organization and its parent. Accepted values: * `Account` * `Company` * `HoldingCompany` * `ParentAccount` {#partymgmt-POST-organization__ul_ljc_bsf_dkc} 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 {#partymgmt-POST-organization__ul_ywf_1nj_jhc} 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 {#partymgmt-POST-organization__ul_hkz_g2c_sjc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-POST-organization__ul_ccy_vmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-POST-organization__ul_cxf_1nj_jhc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [Table 51. Request body parameters (XML or JSON)] {#partymgmt-POST-organization__id_gby_knj_jhc} ### Headers The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-POST-organization__entry__98}{#partymgmt-POST-organization__accept-RESTAPI} | Header | Description | |-|-| | Accept | Data format of the response body. Supported types: application/json or application/xml. Default: application/json | [Table 52. Request headers] {#partymgmt-POST-organization__entry__102} | Header | Description | |-|-| | None | | [Table 53. Response headers] ### Status codes The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other."). {#partymgmt-POST-organization__entry__106} | Status code | Description | |-|-| | 200 | Successful. The request was successfully processed. Note: Response may include a warning array if: * Invalid relatedParty IDs are provided (related contact or party doesn't exist). * Invalid locationId is provided in contactMedium. Example warning: `relatedParty[0] is incorrect. User does not exist`. {#partymgmt-POST-organization__ul_gpz_mvf_dkc} | [Table 54. Status codes] ### Response body parameters (JSON or XML) ### Response body parameters (JSON or XML) {#partymgmt-POST-organization__id_u4c_sm4_3hc} {#partymgmt-POST-organization__table_edn_qnn_3hc__entry__2} | Name | Description | |-|-| | @type | Specifies the object type being created. Determines whether the request creates an Account, Consumer, or Contact record. Replaces the previous `PartyOrPartyRole` object. Valid values: * `Account` * `Consumer` * `Contact` {#partymgmt-POST-organization__ul_pfh_gny_ckc} 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", "contactType": "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 {#partymgmt-POST-organization__ul_vxy_4jn_3hc} 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 {#partymgmt-POST-organization__ul_lq4_fjn_3hc} 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 {#partymgmt-POST-organization__ul_swk_tl4_3hc} Data type: String | | contactMedium.street1 | Describes the street. Data type: String | | contactMedium.street2 | Complementary street description. Data type: String | | createdDate | Timestamp when the organization record was created (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | externalId | An external system identifier that links the party record to your source system or third-party application. 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 | | lastModifiedDate | Timestamp when the organization record was last modified (ISO 8601 format). Data type: String Example: "2025-06-25T14:32:18.000Z" | | 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 {#partymgmt-POST-organization__ul_tyq_y3n_3hc} 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 | | relatedParty | List of parties or party roles related to this party. Data type: Array of Objects "relatedParty": [ { "@type": "User", "role": "String" } ] | | relatedParty.@type | The type of related party. For Consumer creation, use `"User"`. This value indicates that a new Consumer user will be created in ServiceNow, or if a matching user exists, it will be associated with the new Consumer. Data type: String | | relatedParty.role | Functional, business role that the related party plays in the context of the current entity. Possible values: * Company (if related party is User) * Department (if related party is User) * Account (if related party is Customer) * User (if related party is Consumer) {#partymgmt-POST-organization__ul_f1w_wmy_ckc} Data type: String | | status | Flag that indicates the status of organization. Valid values: * active: Organization is active. * inactive: Organization is inactive. {#partymgmt-POST-organization__ul_ldr_k3n_3hc} Data type: Boolean | | tradingName | Name that the organization trades under. Data type: String | [ ] {#partymgmt-POST-organization__table_edn_qnn_3hc} ### cURL request This returns specified fields for the party management organization records. curl "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization" \ --request POST \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --user 'user:password' \ --data '{ "name": "SERVICENOW 144", "legalName": "Acme Corp Ltd.", "tradingName": "Acme Inc.", "contactMedium": [ { "preferred": true, "contactType": "email", "emailAddress": "athammhd@email.com", "@type": "EmailContactMedium" }, { "preferred": false, "contactType": "mobilePhone", "phoneNumber": "+1-202-555-0198", "@type": "PhoneContactMedium" }, { "preferred": false, "contactType": "businessPhone", "phoneNumber": "+1-202-555-0198", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "contactType": "homePhone", "phoneNumber": "+1-202-555-0198", "@type": "HomePhoneContactMedium" }, { "preferred": false, "contactType": "postalAddress", "validFor": { "startDateTime": "2017-03-15T07:49:25.246Z" }, "@type": "GeographicAddressContactMedium", "locationId": "12345678901234567", "city": "chennai", "country": "INDIA", "postCode": "608001", "stateOrProvince": "tamil nadu", "street1": "samcon street", "street2": "adyar,chennai" } ], "externalReference": [ { "externalIdentifierType": "Instagram", "id": "Instagram" } ], "partyCharacteristic": [ { "name": "notes", "value": "Testing for update the notes", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "customer", "value": "true", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "registrationCode", "value": "001", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendorType", "value": ["Hardware"], "valueType": "array", "@type": "StringArrayCharacteristic" }, { "name": "industry", "value": "Manufacturing", "valueType": "choice", "@type": "StringCharacteristics" }, { "name": "taxId", "value": "CTNUM1000123", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "numEmployees", "value": "10", "valueType": "integer", "@type": "StringCharacteristics" }, { "name": "rankTier", "value": "Valued Partner", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "publiclyTraded", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "stockSymbol", "value": "Market", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "stockPrice", "value": "1000", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendor", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "manufacturer", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "marketCap", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "profits", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "revenuePerYear", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" } ], "relatedParty": [ { "role": "primaryContact", "partyOrPartyRole": { "givenName": "John", "familyName": "Doe", "email": "john.doe@example.com", "@type": "Individual" } }, { "role": "other", "partyOrPartyRole": { "givenName": "Mary", "familyName": "Star", "email": "mary.star@example.com", "@type": "Individual" } } ], "organizationChildRelationship": [ { "relationshipType": "partneraccount", "organization": { "id": "0fef075b2fe06a10b79db3bf42faf31a", "name": "mhd", "@type": "Organization" } } ], "organizationParentRelationship": { "relationshipType": "Account", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Global Holdings Ltd.", "@type": "Organization" } }, "status": "active", "@type": "Organization" }' Response body. { "id": "0fef075b2fe06a10b79db3bf42faf31c", "href": "http://instance.service-now.com/api/sn_tmf_api/v1/party/organization/0fef075b2fe06a10b79db3bf42faf31c", "name": "SERVICENOW 144", "legalName": "Acme Corp Ltd.", "tradingName": "Acme Inc.", "contactMedium": [ { "preferred": true, "contactType": "email", "emailAddress": "athammhd@email.com", "@type": "EmailContactMedium" }, { "preferred": false, "contactType": "mobilePhone", "phoneNumber": "+1-202-555-0198", "@type": "PhoneContactMedium" }, { "preferred": false, "contactType": "businessPhone", "phoneNumber": "+1-202-555-0198", "@type": "BusinessPhoneContactMedium" }, { "preferred": false, "contactType": "homePhone", "phoneNumber": "+1-202-555-0198", "@type": "HomePhoneContactMedium" }, { "preferred": false, "contactType": "postalAddress", "validFor": { "startDateTime": "2017-03-15T07:49:25.246Z" }, "@type": "GeographicAddressContactMedium", "locationId": "03e588a17be062105e0d5494548cb68c", "city": "chennai", "country": "INDIA", "postCode": "608001", "stateOrProvince": "tamil nadu", "street1": "samcon street", "street2": "adyar,chennai" } ], "externalReference": [ { "externalIdentifierType": "Instagram", "id": "Instagram" } ], "partyCharacteristic": [ { "name": "notes", "value": "Testing for update the notes", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "customer", "value": "true", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "registrationCode", "value": "001", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendorType", "value": ["Hardware"], "valueType": "array", "@type": "StringArrayCharacteristic" }, { "name": "industry", "value": "Manufacturing", "valueType": "choice", "@type": "StringCharacteristics" }, { "name": "taxId", "value": "CTNUM1000123", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "numEmployees", "value": "10", "valueType": "integer", "@type": "StringCharacteristics" }, { "name": "rankTier", "value": "Valued Partner", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "publiclyTraded", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "stockSymbol", "value": "Market", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "stockPrice", "value": "1000", "valueType": "string", "@type": "StringCharacteristics" }, { "name": "vendor", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "manufacturer", "value": "false", "valueType": "boolean", "@type": "StringCharacteristics" }, { "name": "marketCap", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "profits", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" }, { "name": "revenuePerYear", "value": "0", "valueType": "currency", "@type": "StringCharacteristics" } ], "relatedParty": [ { "role": "primaryContact", "partyOrPartyRole": { "id": "eaf68911c35420105252716b7d40ddde", "givenName": "John", "familyName": "Doe", "email": "john.doe@example.com", "name": "John Doe", "@type": "Individual" } }, { "role": "other", "partyOrPartyRole": { "id": "776a22ea11f43110f877366201dea6b7", "givenName": "Mary", "familyName": "Star", "email": "mary.star@example.com", "name": "Mary Star", "@type": "Individual" } } ], "organizationChildRelationship": [ { "relationshipType": "partneraccount", "organization": { "id": "0fef075b2fe06a10b79db3bf42faf31a", "name": "mhd", "@type": "Organization" } } ], "organizationParentRelationship": { "relationshipType": "Account", "organization": { "id": "9e2fd2ee11b43110f877366201dea674", "name": "Global Holdings Ltd.", "@type": "Organization" } }, "status": "active", "@type": "Organization", "createdDate": "2025-06-25T14:32:18.000Z", "lastModifiedDate": "2025-06-25T14:32:18.000Z" }