Set up the First Advantage spoke

task brazil Updated Mar 12, 2026 7 min read setup-first-adv.md
Raw file servicenow.com

Integrate the ServiceNow instance with your First Advantage account using an API key to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the First Advantage spoke.
  • Role required: admin.

Configure a connection for the First Advantage spoke

Configure a connection to your First Advantage account. The First Advantage spoke connection and credential aliases use these connections to perform actions in First Advantage.

Before you begin

Role required: admin.

Acquire the API key from the First Advantage server.

Procedure

  1. Navigate to All > Process Automation > Workflow Studio.

  2. Click the Integrations tab.

  3. Under Connections, toggle and enable the Outbound connections.

  4. Locate the alias for FirstAdvantage and click View Details.

    [Omitted image "first-adv-view-details.png"] Alt text: View Details button on FirstAdvantage alias tile.

    To manage more than one First Advantage connection record, create a new child alias record by selecting Add Connection. For more information about using multiple connections, see Supporting multiple connections.

  5. Select Configure.

    If you are configuring the spoke for the first time, select Configure. Otherwise, select Edit.

    [Omitted image "first-adv-connection-conf.png"] Alt text: Configure button on the First Advantage connection record.

  6. On the form, fill in these fields:

    Field Description
    Connection Information
    Connection Name Name of the connection. The default and read-only name of the first record is the same as that of the connection alias. You can provide a different name when you create a connection record by clicking Add Connection.
    Connection URL Option to provide the connection URL to the First Advantage server. The URL is https://rest-ua.fadv.com.
    Distribution Email Option to provide a distribution email ID.
    Version Option to provide the version of the API.
    Credential Information
    API Key Option to enter the API key that the First Advantage server uses to authenticate access requests.

    [Omitted image "first-adv-conn-form.png"] Alt text: First Advantage connection form.

  7. Select Save.

    The connection record is configured.

Create First Advantage states in your ServiceNow instance

Create First Advantage states to be displayed in the State list in your ServiceNow instance.

Before you begin

Role required: admin

Create the Draft, Ready, and In Progress states

Create the Draft, Ready, and In Progress states in the Task [task] table.

Before you begin

Role required: admin.

Procedure

  1. In the Filter navigator, enter sys_choice.list.

    The records in the Choice [sys_choice] table are displayed.

  2. Click New.

  3. On the form, fill these values and create three records for the Draft state.

    Field Value
    Table Task [task]
    Element state
    Label Draft
    Value 137

    Note:

    • Ensure that you provide the exact numbers in the Value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.
    • Ensure that the record is created in the Global application.

  4. Click Submit.

  5. Similarly, create records for the Ready and In Progress states.

    Field Value
    Table Task [task]
    Element state
    Label Ready
    Value 173
    Field Value
    Table Task [task]
    Element state
    Label In Progress
    Value 181

    Note:

    • Ensure that you provide the exact numbers in the Value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.
    • Ensure that the record is created in the Global application.

Result

The Draft, Ready, and In Progress states are created in the Task [task] table

Create the Complete and Cancelled states

Create the Complete and Cancelled states in the First Advantage Task [sn_fadv_spoke_first_advantage_task] table.

Before you begin

Role required: admin.

Procedure

  1. Navigate to All > First Advantage Spoke > Order Tasks.

  2. Click New.

    Note: Ensure that the record is created in the First Advantage application.

  3. Right-click State and click Configure Choices.

  4. Perform these steps to create the Cancelled state:

    1. Enter Cancelled in New item text.

    2. Enter 149 in Numeric value.

      Note: Ensure that you provide the exact numbers in the Numeric value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.

    3. Click Add.

    4. Click Save.

  5. Perform these steps to create the Complete state:

    1. Enter Complete in New item text.

    2. Enter 127 in Numeric value.

      Note: Ensure that you provide the exact numbers in the Numeric value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.

    3. Click Add.

    4. Click Save.

Result

The Complete and Cancelled states are created in the First Advantage Task [sn_fadv_spoke_first_advantage_task] table.

Create the Complete - Success and Complete - Deal Broken states

Create the Complete - Success and Complete - Deal Broken states in the First Advantage Employee Task [sn_fadv_spoke_first_advantage_employee_task_table] table.

Before you begin

Role required: admin.

Procedure

  1. Navigate to All > First Advantage Spoke > Employee Task.

  2. Click New.

    Note: Ensure that the record is created in the First Advantage application.

  3. Right-click State and click Configure Choices.

  4. Perform these steps to create the Cancelled state:

    1. Enter Complete - Success in New item text.

    2. Enter 161 in Numeric value.

      Note: Ensure that you provide the exact numbers in the Numeric value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.

    3. Click Add.

    4. Click Save.

  5. Perform these steps to create the Complete state:

    1. Enter Complete - Deal Broken in New item text.

    2. Enter 117 in Numeric value.

      Note: Ensure that you provide the exact numbers in the Numeric value field as mentioned here. The spoke flows will not be triggered if there is any change in these numbers.

    3. Click Add.

    4. Click Save.

Result

The Complete - Success and Complete - Deal Broken states are created in the First Advantage Employee Task [sn_fadv_spoke_first_advantage_employee_task_table] table.

Set up First Advantage webhooks

Receive invite and order event updates at your ServiceNow instance by setting up the webhooks.

Before you begin

Role required: admin

Create authorization key for the First Advantage spoke

Create a authorization key to authorise requests from Jenkins.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > System Definition > Scripts - Background.

  2. Enter this command in the Run script (JavaScript executed on server) text field:

    gs.info(GlideSecureRandomUtil.getSecureRandomString(32));

  3. Click Run Script.

  4. Copy and record the generated value for later use.

    [Omitted image "auth-token.png"] Alt text: Client Secret or Authorization Key

Provide key in your ServiceNow instance

Set up the First Advantage webhook by providing key for the First Advantage webhook client.

Before you begin

Procedure

  1. Navigate to All > First Advantage Spoke > FADV Webhook Client Details.

  2. Click New.

  3. On the form, fill these values.

    Field Description
    Name Name to uniquely identify the record.
    Authorization Key Authorization key you had generated. For more information, see Create authorization key for the First Advantage spoke.

  4. Click Submit.

Access API endpoints

Access the API endpoint for the invite and order events and share the required details with First Advantage to set up the webhooks.

Before you begin

Role required: admin

Procedure

  1. Navigate to All > System Web Services > Scripted REST APIs.

  2. Open the record for the First Advantage spoke, for example, First Advantage Webhook.

  3. In the Resources tab:

    1. Open the record for the invite event, for example, Invite Status.

    2. Copy and record the path provided in Resource path, for example, /api/sn_fadv_spoke/fadv/invite_status.

    3. Open the record for the order event, for example, Order Status.

    4. Copy and record the path provided in Resource path, for example, /api/sn_fadv_spoke/fadv/order_status.

What to do next

Contact First Advantage to setup webhooks for your ServiceNow instance. For this, share these details with First Advantage:

  • Custom header in this format: fadvKey <authorization-key>.

    Note:

    • Ensure that the custom header is in this format only. The spoke flows will not be triggered if there is any change.
    • Provide the same key you had earlier provided in First Advantage Spoke > FADV Webhook Client Details.
    • Use the same case as mentioned here: fadvKey.

  • API endpoint for the invite events in this format: <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/invite_status

  • API endpoint for the order events in this format: <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/order_status

Synchronise First Advantage accounts and packages with ServiceNow

Store the details of the First Advantage accounts and packages by synchronizing First Advantage accounts and packages with ServiceNow.

Before you begin

Role required: First Advantage admin

Procedure

  1. Navigate to All > First Advantage Spoke > Accounts.

  2. Click New.

  3. On the form, fill in the values.

    Field Description
    Primary Account Option to specify that the account is a primary account. Select the check box.
    Account ID ID of the primary account.
    Account Name Name of the primary account.

  4. Click Submit.

    The primary account is created and the record is displayed.

  5. Navigate to First Advantage Spoke > Accounts.

  6. Click the Get Accounts related list.

  7. Navigate to First Advantage Spoke > Packages.

  8. Click the Get Packages related link.

Result

The First Advantage account and package details are retrieved.

Note: Only users with the FADV admin role can synchronize the account and package details. Users with FADV user role can only view the retrieved details.

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