{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":439,"path":"api-reference/rest-api-explorer/t_EnableOAuthWithREST.md","title":"Enable OAuth with inbound REST","bundle":null,"doc_type":null,"release":"australia","body":"\n# Enable OAuth with inbound REST\n\nUsing OAuth, you can pass a user ID and password once, and then use a token for subsequent REST requests instead of submitting credentials with each request.\n\n## Before you begin\n\nThe OAuth 2.0 plugin \\(com.snc.platform.security.oauth.is.active\\) must be active. For activation instructions, see [Activate a plugin](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_ActivateAPlugin.md).\n\nRole required: admin\n\n## About this task\n\nOAuth reduces the number of times you submit user credentials. After authenticating once, you use a token for subsequent REST requests.\n\n## Procedure\n\n1.  Set the **com.snc.platform.security.oauth.is.active** system property to `true`.\n\n2.  Navigate to **System OAuth** > **Application Registry**.\n\n3.  Select **New**, then select **Create an OAuth API endpoint for external clients**.\n\n4.  Record the **client\\_id** and **client\\_secret** values to use when requesting an access token.\n\n    **Note:** This example uses the password grant type. You can also configure an OAuth API endpoint using other grant types. For more information, see [OAuth Inbound](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/oauth-inbound.md).\n\n5.  Use a REST client, such as cURL or Postman, to send a POST request to the OAuth endpoint \\(`oauth_token.do`\\).\n\n    Format the request as a URL-encoded HTTP POST body and include the required parameters.\n\n6.  Record the access token and refresh token from the response.\n\n7.  Submit the access token with subsequent REST requests.\n\n\n-   **[REST OAuth example](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/r_RESTOAuthExample.md)**  \nThis example shows how to authenticate an inbound REST request using OAuth.\n\n**Parent Topic:**[REST APIs](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/rest-api-explorer/c_RESTAPI.md)\n\n"}}