---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Create API endpoints for external clients

# Create OAuth API endpoints for external clients {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

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.
<br />

## Before you begin

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.

Role required: admin

## About this task

To create OAuth API endpoints for external clients and use OAuth in your pipelines, you must create several records, each on different instances in your pipeline. Begin on your production instance, which should be your
controller instance.

## Procedure

1. On your production instance, navigate to AllSystem OAuthApplication Registry.
2. Select New.
3. Select Create an OAuth API endpoint for external clients.
4. On the form, fill in the fields.  
   {#create-oauth-api-endpoints-for-external-clients__table_wcz_drq_fyb__entry__2}

   | Field | Action |
   |-|-|
   | Name | Enter <kbd class="ph userinput">Pipeline Controller Client</kbd>. |
   | Redirect URLs | 1. Unlock the field. 2. Enter the URL for your production, development, and test instances, each with <kbd class="ph userinput">oauth_redirect.do</kbd> after the backslash. 3. Lock the field. {#create-oauth-api-endpoints-for-external-clients__ol_wm4_bvw_fyb} Separate each of the three URLs with a comma and a space. For example: https://\<production instance name\>.service-now.com/oauth_redirect.do, https://\<development instance name\>.service-now.com/oauth_redirect.do, https://\<test instance name\>.service-now.com/oauth_redirect.do. |
   [Table 1. Application Registries form]

   {#create-oauth-api-endpoints-for-external-clients__table_wcz_drq_fyb}
5. Select Submit.  
   Important:  
   Complete the next steps on your development instance.
6. On your development instance, navigate to AllSystem OAuthApplication Registry.
7. Select New.
8. Select Create an OAuth API endpoint for external clients.
9. On the form, fill in the fields.  
   {#create-oauth-api-endpoints-for-external-clients__table_phy_3rq_fyb__entry__2}

   | Field | Action |
   |-|-|
   | Name | Enter <kbd class="ph userinput">Pipeline Development Client</kbd>. |
   | Redirect URLs | 1. Unlock the field. 2. Enter the URL for your production and development instances, each with <kbd class="ph userinput">oauth_redirect.do</kbd> after the backslash. 3. Lock the field. {#create-oauth-api-endpoints-for-external-clients__ol_jxg_fvw_fyb} Separate the two URLs with a comma and a space. For example: https://\<production instance name\>.service-now.com/oauth_redirect.do, https://\<development instance name\>.service-now.com/oauth_redirect.do. |
   [Table 2. Application Registries form]

   {#create-oauth-api-endpoints-for-external-clients__table_phy_3rq_fyb}
10. Select Submit.  
    Important:  
    Complete the next steps on your test instance.
11. On your test instance, navigate to AllSystem OAuthApplication Registry.
12. Select New.
13. Select Create an OAuth API endpoint for external clients.
14. On the form, fill in the fields.  
    {#create-oauth-api-endpoints-for-external-clients__table_f4d_nrq_fyb__entry__2}

    | Field | Action |
    |-|-|
    | Name | Enter <kbd class="ph userinput">Pipeline Test Client</kbd>. |
    | Redirect URLs | 1. Unlock the field. 2. Enter the URL for your production and test instances, each with <kbd class="ph userinput">oauth_redirect.do</kbd> after the backslash. 3. Lock the field. {#create-oauth-api-endpoints-for-external-clients__ol_zmv_3vw_fyb} Separate the two URLs with a comma and a space. For example: https://\<production instance name\>.service-now.com/oauth_redirect.do, https://\<test instance name\>.service-now.com/oauth_redirect.do. |
    [Table 3. Application Registries form]

    {#create-oauth-api-endpoints-for-external-clients__table_f4d_nrq_fyb}
15. Select Submit.
16. **Optional:** Repeat this process from steps 11--15 for any other non-production instances (staging, and the like) you have.

## What to do next

Follow the steps in [Create third-party OAuth provider records](https://www.servicenow.com/docs/qRI7oO3ado72_Wy3B5rpLg "Create third-party OAuth provider records to enable each of your instances to access the API endpoints you've created.") on the specified instances.

*[\>]: and then