The ServiceNow API handles the OAuth2 authentication process and API requests. When developing a ServiceNow integration, follow these steps:

  1. Import the API module to the integration.
  2. Add the !servicenow-login command, which will create a refresh token using the given credentials. The refresh token will be used to generate access tokens to the instance of the user.
  3. (Optional) Add the !servicenow-test command, which will test the instance configuration.

To use the common ServiceNow API logic, attach the from ServiceNowApiModule import * # noqa: E402 line of code after the main() definition, before it is called to import it as shown in the example below. After you import the module, the ServiceNowClient will be available for use.

def main():
from ServiceNowApiModule import * # noqa: E402
if __name__ in ["builtins", "__main__"]:

For examples, see the ServiceNow_CMDB integration.