Resource owner password credential grant workflow

task brazil Updated Nov 6, 2026 1 min read resource-owner-password-credential-workflow.md
Raw file servicenow.com

This flow is used in legacy or highly controlled environments where secure alternatives aren't feasible. The client app directly collects and sends user credentials to ServiceNow to obtain an access token, making it suitable only for trusted internal use.

Before you begin

Role required: oauth_admin, mi_admin, admin

About this task

This procedure outlines how a trusted client application obtains an access token by directly handling user credentials and uses it to access ServiceNow APIs.

The user logs in through the app, which sends both its own credentials and the user's to ServiceNow. ServiceNow validates the credentials and issues an access token that the app uses to call APIs.

[Omitted image "mic-jwt-grant-workflow.png"] Alt text: Resource owner password credential grant workflow

Procedure

  1. The user logs in to the client application.

  2. The client application sends a token request to with the following parameters:

    • Client ID and client secret.
    • Username and password of the user. Example
    Text
    Method: POSTEndpoint: https://<servicenow_base_url>/oauth_token.doHeaders: Content-Type: application/x-www-form-urlencoded

Parameter

Required

Description

grant_type

Yes

Specifies the OAuth grant type.

client_id

Yes

The unique identifier for your client application.Format: YOUR_CLIENT_ID

client_secret

Yes

The client application's secret key.Format: YOUR_CLIENT_SECRET

username

Yes

The user’s ServiceNow username.

password

Yes

The user’s ServiceNow password.

scope

Optional

Defines the level of access requested.Example:

  • incident_read
  • incident_write
3. ServiceNow validates both the client and user credentials, and returns the access token.
  1. The client uses the access token to call ServiceNow APIs.

    Example

    Text
    Method: GETEndpoint: https://<servicenow_base_url/api/now/incidentAuthorization: Bearer YOUR_ACCESS_TOKEN
  2. ServiceNow validates the access token, and returns the API response.

Search documentation
Search document titles and file paths on the brazil branch