ServiceNow · Schema

ContactCreate

Contact creation request

ServiceNowAutomationCloud ServicesDigital WorkflowsEnterprise PlatformITSMProcessesT1Workflow AutomationWorkflowsA2A

Properties

Name	Type	Description
name	string	Contact full name
first_name	string	Contact first name
middle_name	string	Contact middle name
last_name	string	Contact last name
user_name	string	Contact user ID
email	string	Contact email address
phone	string	Contact business phone number
mobile_phone	string	Contact mobile phone number
home_phone	string	Contact home phone number
title	string	Contact business title
employee_number	string	Contact employee number
company	string	Sys_id of the company record
account	string	Sys_id of the account record
department	string	Sys_id of the department
manager	string	Sys_id of the direct supervisor
location	string	Sys_id of the location
building	string	Sys_id of the building
street	string	Contact street address
city	string	City in which the contact resides
state	string	State in which the contact resides
zip	string	Contact zip code
country	string	Country code
active	boolean	Flag indicating whether the contact is active
vip	boolean	Flag indicating whether the contact has VIP status
locked_out	boolean	Flag indicating if the contact is locked-out
web_service_access_only	boolean	Flag indicating whether the contact can only access services through the web
internal_integration_user	boolean	Flag indicating whether the contact is an internal integration user
enable_multifactor_authn	boolean	Flag indicating whether multifactor authorization is required
geolocation_tracked	boolean	Flag indicating whether the contact location is obtained through geotracking
notification	integer	Indicates whether the contact should receive notifications (1=Disabled, 2=Enabled)
calendar_integration	integer	Calendar application that the contact uses (1=Outlook)
failed_attempts	integer	Number of failed login attempts
latitude	number	Latitude coordinate of the contact
longitude	number	Longitude coordinate of the contact
time_zone	string	Time zone in which the contact resides
date_format	string	Format in which to display dates
time_format	string	Format in which to display time
preferred_language	string	Country code of the contact primary language
gender	string	Contact gender
photo	string	Photo image of the contact
introduction	string	Introduction
source	string	Source of the contact
roles	string	List of user roles associated with the contact
cost_center	string	Sys_id of the cost center
schedule	string	Sys_id of the work schedule
time_sheet_policy	string	Sys_id of the time sheet policy
default_perspective	string	Sys_id of the default perspective
ldap_server	string	Sys_id of the LDAP server
agent_status	string	Status of the agent
on_schedule	string	Indicates the timeliness of dispatched service personnel
edu_status	string	Education status of the contact
last_login_time	string	Date and time the contact logged in to the system
last_login_device	string	Device the consumer used the last time they logged in
social_channel	string	Social media channel (Twitter, Facebook, Instagram, etc.)
social_handle	string	User handle on the social media channel
social_handle_url	string	URL to the contact's social channel profile

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/servicenow/main/json-schema/servicenow-contact-create-schema.json",
  "title": "ContactCreate",
  "description": "Contact creation request",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/servicenow-contact-api-openapi.yml#/components/schemas/ContactCreate",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 151,
      "description": "Contact full name"
    },
    "first_name": {
      "type": "string",
      "maxLength": 50,
      "description": "Contact first name"
    },
    "middle_name": {
      "type": "string",
      "maxLength": 50,
      "description": "Contact middle name"
    },
    "last_name": {
      "type": "string",
      "maxLength": 50,
      "description": "Contact last name"
    },
    "user_name": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact user ID"
    },
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "phone": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact business phone number"
    },
    "mobile_phone": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact mobile phone number"
    },
    "home_phone": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact home phone number"
    },
    "title": {
      "type": "string",
      "maxLength": 60,
      "description": "Contact business title"
    },
    "employee_number": {
      "type": "string",
      "description": "Contact employee number"
    },
    "company": {
      "type": "string",
      "description": "Sys_id of the company record"
    },
    "account": {
      "type": "string",
      "description": "Sys_id of the account record"
    },
    "department": {
      "type": "string",
      "description": "Sys_id of the department"
    },
    "manager": {
      "type": "string",
      "description": "Sys_id of the direct supervisor"
    },
    "location": {
      "type": "string",
      "description": "Sys_id of the location"
    },
    "building": {
      "type": "string",
      "description": "Sys_id of the building"
    },
    "street": {
      "type": "string",
      "maxLength": 255,
      "description": "Contact street address"
    },
    "city": {
      "type": "string",
      "maxLength": 40,
      "description": "City in which the contact resides"
    },
    "state": {
      "type": "string",
      "maxLength": 40,
      "description": "State in which the contact resides"
    },
    "zip": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact zip code"
    },
    "country": {
      "type": "string",
      "maxLength": 3,
      "description": "Country code"
    },
    "active": {
      "type": "boolean",
      "default": true,
      "description": "Flag indicating whether the contact is active"
    },
    "vip": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating whether the contact has VIP status"
    },
    "locked_out": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating if the contact is locked-out"
    },
    "web_service_access_only": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating whether the contact can only access services through the web"
    },
    "internal_integration_user": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating whether the contact is an internal integration user"
    },
    "enable_multifactor_authn": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating whether multifactor authorization is required"
    },
    "geolocation_tracked": {
      "type": "boolean",
      "default": false,
      "description": "Flag indicating whether the contact location is obtained through geotracking"
    },
    "notification": {
      "type": "integer",
      "default": 2,
      "description": "Indicates whether the contact should receive notifications (1=Disabled, 2=Enabled)",
      "enum": [
        1,
        2
      ]
    },
    "calendar_integration": {
      "type": "integer",
      "default": 1,
      "description": "Calendar application that the contact uses (1=Outlook)"
    },
    "failed_attempts": {
      "type": "integer",
      "description": "Number of failed login attempts"
    },
    "latitude": {
      "type": "number",
      "format": "float",
      "description": "Latitude coordinate of the contact"
    },
    "longitude": {
      "type": "number",
      "format": "float",
      "description": "Longitude coordinate of the contact"
    },
    "time_zone": {
      "type": "string",
      "maxLength": 40,
      "description": "Time zone in which the contact resides"
    },
    "date_format": {
      "type": "string",
      "maxLength": 40,
      "description": "Format in which to display dates",
      "enum": [
        "dd/mm/yyyy",
        "dd-mm-yyyy",
        "dd.mm.yyyy",
        "mm-dd-yyyy",
        "yyyy-mm-dd"
      ]
    },
    "time_format": {
      "type": "string",
      "maxLength": 40,
      "description": "Format in which to display time",
      "enum": [
        "hh.mm.ss a",
        "hh:mm:ss a",
        "HH.mm.ss",
        "HH:mm:ss"
      ]
    },
    "preferred_language": {
      "type": "string",
      "maxLength": 3,
      "description": "Country code of the contact primary language"
    },
    "gender": {
      "type": "string",
      "maxLength": 40,
      "description": "Contact gender"
    },
    "photo": {
      "type": "string",
      "description": "Photo image of the contact"
    },
    "introduction": {
      "type": "string",
      "maxLength": 40,
      "description": "Introduction"
    },
    "source": {
      "type": "string",
      "maxLength": 255,
      "description": "Source of the contact"
    },
    "roles": {
      "type": "string",
      "maxLength": 40,
      "description": "List of user roles associated with the contact"
    },
    "cost_center": {
      "type": "string",
      "description": "Sys_id of the cost center"
    },
    "schedule": {
      "type": "string",
      "description": "Sys_id of the work schedule"
    },
    "time_sheet_policy": {
      "type": "string",
      "description": "Sys_id of the time sheet policy"
    },
    "default_perspective": {
      "type": "string",
      "description": "Sys_id of the default perspective"
    },
    "ldap_server": {
      "type": "string",
      "description": "Sys_id of the LDAP server"
    },
    "agent_status": {
      "type": "string",
      "maxLength": 40,
      "description": "Status of the agent",
      "enum": [
        "Off work",
        "On break",
        "On route",
        "On site"
      ]
    },
    "on_schedule": {
      "type": "string",
      "maxLength": 40,
      "description": "Indicates the timeliness of dispatched service personnel",
      "enum": [
        "Ahead",
        "behind_less30",
        "behind_30to60",
        "behind_more60",
        "on_time"
      ]
    },
    "edu_status": {
      "type": "string",
      "maxLength": 40,
      "default": "faculty",
      "description": "Education status of the contact"
    },
    "last_login_time": {
      "type": "string",
      "format": "date-time",
      "description": "Date and time the contact logged in to the system"
    },
    "last_login_device": {
      "type": "string",
      "maxLength": 40,
      "description": "Device the consumer used the last time they logged in"
    },
    "social_channel": {
      "type": "string",
      "description": "Social media channel (Twitter, Facebook, Instagram, etc.)"
    },
    "social_handle": {
      "type": "string",
      "description": "User handle on the social media channel"
    },
    "social_handle_url": {
      "type": "string",
      "description": "URL to the contact's social channel profile"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/servicenow-contact-create"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.