Supported data types for ServiceNow custom attributes
Use these data types when you configure your ServiceNow application profile.
| ServiceNow data type | Verify data type | Considerations |
|---|---|---|
| String | String | The maximum length can be customized. |
| True/False | Boolean/string | The string values true or false can be passed. If the string contains other characters, the endpoint ignores it. |
| Integer | Number/string | A string value or a number like "1234" can be passed. If it contains characters, the endpoint ignores it. |
| Floating point number | String | A string value or a number with up to 7 digits after the decimal point can be passed. If it contains other characters, the endpoint ignores it. |
| Decimal | String | A string value or a number with up to 2 digits after the decimal point can be passed. If it contains other characters, the endpoint ignores it. |
| Long | String | Same as integer, but allows to store higher numbers. If the string contains other characters, the endpoint ignores it. |
| Date | String | The accepted format is YYYY-MM-DD. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Datetime | String | The accepted format is YYYY-MM-DD HH:mm:ss. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Time | String | Since 1970, the accepted format is YYYY-MM-DD HH:mm:ss, but only HH:mm:ss is used to track the time. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Color | String | An appropriate color name is passed. If the string contains other characters, the endpoint ignores it. |
| Ip Address | String | IPv4 and IPv6 addresses can be passed. If the string contains other characters, the endpoint ignores it. |
| Due date | String | The accepted format is YYYY-MM-DD HH:mm:ss. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Calendar date time | String | The accepted format is YYYY-MM-DD HH:mm:ss. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Choice | String | One choice from the list of choices can be passed. If more than one choice or string is passed, the endpoint ignores it. |
| Currency | String | A decimal value with four digits after the decimal point is passed. If it is reset, it is set to 0. If the string contains other characters, the endpoint ignores it. |
| Field name | String | A reference field for a field name in the table selected in a Table Name field type. If the string contains other characters, the endpoint ignores it. |
| HTML | String | If an invalid HTML string is passed, the endpoint ignores it. |
| List | String | A reference field that accepts multiple references. If the string contains other characters, the endpoint ignores it. |
| Percent complete | String | A decimal value is passed. If the string contains other characters, the endpoint ignores it. |
| Phone number | String | The string that is passed must be in E164-compliant format. If the string contains other characters, the endpoint ignores it. |
| Price | String | A decimal value is passed. If it is reset, it is set to 0. If the string contains other characters, the endpoint ignores it. |
| Script | String | The maximum length can be customized. |
| Script plain | String | The maximum length can be customized. |
| String UTF | String | The maximum length can be customized. |
| Suggestion | String | The maximum length can be customized. |
| Translated text | String | The maximum length can be customized. |
| Translate HTML | String | The maximum length can be customized. |
| UTC Time | String | Since 1970, the accepted format is YYYY-MM-DD HH:mm:ss, but only HH:mm:ss is used to track the time. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
| Wiki | String | The maximum length can be customized. |
| Workflow | String | The maximum length can be customized. |
| Duration | String | Since 1970, the accepted format is YYYY-MM-DD HH:mm:ss, but only HH:mm:ss is used to track the time. If other characters are passed in the string, the endpoint might parse it incorrectly and store a wrong value. |
Note: The API does not support the required field constraint. If a User table’s
column is created with the required field constraint, ServiceNow can create users without
the required field through the API. All columns support the read-only and default value
constraints.