Breadcrumbs

S4 - Add ServiceNow as a Destination for CI Sync

Extended Page Title

Step 7 - Add your ServiceNow Instance as a Destination Connection for CI Sync via the CI Sync Web UI

Task List

Task #

Task

Performed by

1

Add a ServiceNow Destination Connection for CI Sync

CI Sync Admin

Task 1: Add a ServiceNow Destination Connection in CI Sync

  1. Login to your CI Sync SaaS application user interface using your company specific URL and with your user account in the same AAD tenancy that the CI Sync SaaS application was registered in.  The URL will be in the format of: https://YourCo.syncfish.app

Picture 1.png

  1. Go to the Settings page and under the ServiceNow Connections heading, click the  [+ Add] button

image-20250328-005905.png
image-20250328-005911.png


  1. Update the fields as follows:

    1. Enter a friendly name into the Connection name field.

    2. Leave the default Read Batch size of 1000

    3. Leave the default Write Batch size of 200

    4. Select the relevant value for the Environment related to this connection.  The options are:

      1. Test

      2. Production

Informational Note

The Connection Name and Environment values entered here control the Destinations you see on the “Run” page in the CI Sync User Interface where you are setting up a CI Sync job.

  1. Continue to update the fields as follows:

    1. Enter the Instance URL for the ServiceNow instance. e.g. https://YourCo.syncfish.app

Guidance Note

  • If this connection is for your TEST ServiceNow instance, enter the non-production ServiceNow instance URL.

  • If this connection is for your PROD ServiceNow instance, enter the production ServiceNow instance URL.

  1. Select the Authentication type as one of the following

    1. Basic

    2. OAuth

Click to expand the instructions for Basic Authentication

  • Enter username, password

Gudiance Note

This relates to the ServiceNow user (and Basic Auth details) setup during Task 3: Create a User Account (to be used by your CI Sync SaaS instance) within S3 - Configure ServiceNow for CI Sync.

image-20250328-031111.png

  • Tick the “I consent…” checkbox

  • Click “Create connection”

Click to expand the instructions for OAuth Authentication

  • Enter username, password, client id and client secret

Gudiance Note

This relates to the ServiceNow user (and OAuth details) setup during Task 5: (Optional) Configure OAuth Authencitation on the CI Sync User Account within S3 - Configure ServiceNow for CI Sync.

image-20250328-032007.png

  • Tick the “I consent…” checkbox

  • Click “Create connection”


  1. Go back to the Settings page

  2. Confirm you have a green light against your newly created ServiceNow connection (for destination system access).

CleanShot 2025-08-10 at 13.55.54@2x-20250810-035611.png

  1. If you don’t see green against your ServiceNow connection, then

  2. Recheck the connection settings for ServiceNow in the CI Sync UI.

  3. Recheck the authentication details are correct on the ServiceNow end.

  4. After you have green lights on the source and destination connections:

    1. Click on the Health Check heading and ensure you have green lights/ticks against the various sections on the page.

    2. If any of the indicators are not green, please contact the Syncfish Support team.

CleanShot 2025-08-10 at 14.00.00@2x-20250810-040019.png