---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Create third-party OAuth provider records

# Create third-party OAuth provider records {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read

Create third-party OAuth provider records to enable each of your instances to access the API endpoints you've created.

## Before you begin

Complete the tasks in [Create OAuth API endpoints for external clients](https://servicenow-prod.fluidtopics.net/sJjM2gKyo2Bvm3FyZ6xXbg "Create OAuth API endpoints to enable your controller instance to have two-way communication with your non-production instances. Follow and complete each step carefully on the specified instances before moving on to create your third-party OAuth provider records.").

In the top right corner of your instance, make sure you set the application scope to Global.

Open all of your instances (development, test, production, and the like) in separate browser tabs. Begin the steps below on the production instance.

Role required: admin

## Procedure

1. On your production instance, navigate to AllSystem OAuthApplication Registry.  
   You must create three records here, one for each of the three instances (development, test, and production). If you have any additional non-production instances (staging, and the like), create a record for each of those following the method shown here.

   <br />

2. Select New.
3. Select Connect to a third party OAuth Provider to create a record for your development instance.
4. On the form, fill in the fields.  
   {#create-third-party-oauth-provider-records__table_dgb_1qq_fyb__entry__2}

   | Field | Action |
   |-|-|
   | Name | Enter <kbd class="ph userinput">Dev Instance Connection</kbd>. |
   | Client ID | 1. On your development instance, open the Application Registry list (AllSystem OAuthApplication Registry). 2. Open the Pipeline Development Client record. 3. Copy the Client ID. 4. On your production instance, paste the Client ID from your development instance into the Client ID field. {#create-third-party-oauth-provider-records__ol_vz2_cqq_fyb} |
   | Client Secret | 1. On your development instance, open the Application Registry list (AllSystem OAuthApplication Registry). 2. Open the Pipeline Development Client record. 3. Unlock the Client Secret field and copy the text. 4. On your production instance, paste the Client Secret from your development instance in the Client Secret field. {#create-third-party-oauth-provider-records__ol_flh_2qq_fyb} |
   | Default Grant type | Change to Authorization code. |
   | Authorization URL | 1. Unlock the field. 2. Enter the URL for your development instance followed by <kbd class="ph userinput">oauth_auth.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_jyl_xvw_fyb}For example: https://\<development instance name\>.service-now.com/oauth_auth.do. |
   | Token URL | 1. Unlock the field. 2. Enter the URL for your development instance followed by <kbd class="ph userinput">oauth_token.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_azh_yvw_fyb}For example: https://\<development instance name\>.service-now.com/oauth_token.do. |
   [Table 1. Application Registries form]

   {#create-third-party-oauth-provider-records__table_dgb_1qq_fyb}
5. Select Submit.
6. Select New.
7. Select Connect to a third party OAuth Provider to create a record for your test instance.
8. On the form, fill in the fields.  
   {#create-third-party-oauth-provider-records__table_tzx_fqq_fyb__entry__2}

   | Field | Action |
   |-|-|
   | Name | Enter <kbd class="ph userinput">Test Instance Connection</kbd>. |
   | Client ID | 1. On your test instance, open the Application Registry list (AllSystem OAuthApplication Registry). 2. Open the Pipeline Test Client record. 3. Copy the Client ID. 4. On your production instance, paste the Client ID from your test instance into the Client ID field. {#create-third-party-oauth-provider-records__ol_rbx_3qq_fyb} |
   | Client Secret | 1. On your test instance, open the Application Registry list (AllSystem OAuthApplication Registry). 2. Open the Pipeline Test Client record. 3. Unlock the Client Secret field and copy the text. 4. On your production instance, paste the Client Secret from your test instance in the Client Secret field. {#create-third-party-oauth-provider-records__ol_n2x_3qq_fyb} |
   | Default Grant type | Change to Authorization code. |
   | Authorization URL | 1. Unlock the field. 2. Enter the URL for your test instance followed by <kbd class="ph userinput">oauth_auth.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_ndq_yvw_fyb}For example: https://\<test instance name\>.service-now.com/oauth_auth.do. |
   | Token URL | 1. Unlock the field. 2. Enter the URL for your test instance followed by <kbd class="ph userinput">oauth_token.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_t5s_yvw_fyb}For example: https://\<test instance name\>.service-now.com/oauth_token.do. |
   [Table 2. Application Registries form]

   {#create-third-party-oauth-provider-records__table_tzx_fqq_fyb}
9. Select Submit.
10. On the Application Registry list, select the Pipeline Controller Client record.
11. Copy the Client ID and paste it somewhere like a notes application.
12. Unlock the Client Secret field, copy the text, and paste it in a note with the Client ID.
13. Go back to the Application Registry list and select New.
14. Select Connect to a third party OAuth Provider to create a record for your production instance.
15. On the form, fill in the fields.  
    {#create-third-party-oauth-provider-records__table_hfw_jqq_fyb__entry__2}

    | Field | Action |
    |-|-|
    | Name | Enter <kbd class="ph userinput">Prod Instance Connection</kbd>. |
    | Client ID | 1. Copy the Client ID that you noted down. 2. Paste the Client ID into the Client ID field. {#create-third-party-oauth-provider-records__ol_ftm_lqq_fyb} |
    | Client Secret | 1. Copy the Client Secret that you noted down. 2. Unlock the Client Secret field, and paste the text in the field. {#create-third-party-oauth-provider-records__ol_qvm_lqq_fyb} |
    | Default Grant type | Change to Authorization code. |
    | Authorization URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_auth.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_kxz_yvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_auth.do. |
    | Token URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_token.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_gtc_zvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_token.do. |
    [Table 3. Application Registries form]

    {#create-third-party-oauth-provider-records__table_hfw_jqq_fyb}
16. Select Submit.  
    Important:  
    Complete the next steps on your development instance.
17. On your development instance, navigate to AllSystem OAuthApplication Registry.  
    <br />

18. Select New.
19. Select Connect to a third party OAuth Provider to create a record for your production instance.
20. On the form, fill in the fields.  
    {#create-third-party-oauth-provider-records__table_ar4_mqq_fyb__entry__2}

    | Field | Action |
    |-|-|
    | Name | Enter <kbd class="ph userinput">Prod Instance Connection</kbd>. |
    | Client ID | 1. Copy the Client ID that you noted down. 2. Paste the Client ID into the Client ID field. {#create-third-party-oauth-provider-records__ol_y5d_pqq_fyb} |
    | Client Secret | 1. Copy the Client Secret that you noted down. 2. Unlock the Client Secret field, and paste the text in the field. {#create-third-party-oauth-provider-records__ol_gxd_pqq_fyb} |
    | Default Grant type | Change to Authorization code. |
    | Authorization URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_auth.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_mdj_zvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_auth.do. |
    | Token URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_token.do</kbd>. 3. Lock the field. {#create-third-party-oauth-provider-records__ol_lll_zvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_token.do. |
    [Table 4. Application Registries form]

    {#create-third-party-oauth-provider-records__table_ar4_mqq_fyb}
21. Select Submit.  
    Important:  
    Complete the next steps on your test instance.
22. On your test instance, navigate to AllSystem OAuthApplication Registry.
23. Select New.
24. Select Connect to a third party OAuth Provider to create a record for your production instance.
25. On the form, fill in the fields.  
    {#create-third-party-oauth-provider-records__table_irq_xqq_fyb__entry__2}

    | Field | Action |
    |-|-|
    | Name | Enter <kbd class="ph userinput">Prod Instance Connection</kbd>. |
    | Client ID | 1. Copy the Client ID that you noted down. 2. Paste the Client ID into the Client ID field. {#create-third-party-oauth-provider-records__ol_v4r_zqq_fyb} |
    | Client Secret | 1. Copy the Client Secret that you noted down. 2. Unlock the Client Secret field, and paste the text in the field. {#create-third-party-oauth-provider-records__ol_qqr_zqq_fyb} |
    | Default Grant type | Change to Authorization code. |
    | Authorization URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_auth.do</kbd> 3. Lock the field. {#create-third-party-oauth-provider-records__ol_rls_zvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_auth.do. |
    | Token URL | 1. Unlock the field. 2. Enter the URL for your production instance followed by <kbd class="ph userinput">oauth_token.do</kbd> 3. Lock the field. {#create-third-party-oauth-provider-records__ol_o2x_zvw_fyb}For example: https://\<production instance name\>.service-now.com/oauth_token.do. |
    [Table 5. Application Registries form]

    {#create-third-party-oauth-provider-records__table_irq_xqq_fyb}
26. Select Submit.
27. **Optional:** Repeat steps 22--26 for any other non-production instances that you have (staging, and the like).

## What to do next

Now that you've completed the pre-work for using OAuth, complete all the steps in [Use OAuth to create pipeline credentials](https://servicenow-prod.fluidtopics.net/3RAMk2yLgsyf7e5RHHL5yQ "Create credential records on each of your instances to enable OAuth use in your pipeline.") on the specified instances.

*[\>]: and then