Set up the First Advantage spoke

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 7 min. de leitura

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

    Antes de Iniciar

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

    Create Credential record for the First Advantage spoke

    Create Credential records to the First Advantage spoke. The First Advantage spoke connection and credential alias uses these credentials to authorize actions.

    Antes de Iniciar

    Role required: admin.

    Procedimento

    1. Navigate to All > Connections & Credentials > Credentials.
    2. Click New.
      The system displays the message What type of Credentials would you like to create?.
    3. Select API Key Credentials.
      A blank API Key Credentials form displays.
    4. Enter these values.
      Field Value required
      Name Name to uniquely identify the record. For example, enter FADV Credentials.
      Active Option to actively use the credential record.
      API Key API key generated for your First Advantage instance.
      Nota:
      Contact the First Advantage team to obtain the API key.
      Order Select the order to apply this credential. For example, enter 100.
    5. Click Submit.

    Create Connection record for the First Advantage spoke

    Create a connection record to integrate your ServiceNow instance and the First Advantage server. Your ServiceNow instance uses this connection record to perform the First Advantage spoke actions.

    Antes de Iniciar

    Role required: admin.

    Acquire the API key from the First Advantage server.

    Procedimento

    1. Navigate to All > Process Automation > Workflow Studio.
    2. Select Integrations.
    3. Select the Connections tab.
    4. In the Search all connections field, enter First Advantage.
      Confirm that the Outbound tab is selected.
    5. On the FirstAdvantage tile, select View Details.
      View Details button on FirstAdvantage alias tile.
    6. Select Configure.
    7. Fill the form.
      Tabela 1. First Advantage spoke connection form
      Field Description
      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.
      API Key Option to enter the API key that the First Advantage server uses to authenticate access requests.
      First Advantage connection form.
    8. Select Configure Connection.
      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.

    Antes de Iniciar

    Role required: admin

    Create the Draft, Ready, and In Progress states

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

    Antes de Iniciar

    Role required: admin.

    Procedimento

    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.
      Tabela 2. Record 1 - Draft state
      Field Value
      Table Task [task]
      Element state
      Label Draft
      Value 137
      Nota:
      • 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.
      Tabela 3. Record 2 - Ready state
      Field Value
      Table Task [task]
      Element state
      Label Ready
      Value 173
      Tabela 4. Record 3 - In Progress state
      Field Value
      Table Task [task]
      Element state
      Label In Progress
      Value 181
      Nota:
      • 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.

    Resultado

    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.

    Antes de Iniciar

    Role required: admin.

    Procedimento

    1. Navigate to All > First Advantage Spoke > Order Tasks.
    2. Click New.
      Nota:
      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.
        Nota:
        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.
        Nota:
        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.

    Resultado

    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.

    Antes de Iniciar

    Role required: admin.

    Procedimento

    1. Navigate to All > First Advantage Spoke > Employee Task.
    2. Click New.
      Nota:
      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.
        Nota:
        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.
        Nota:
        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.

    Resultado

    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.

    Antes de Iniciar

    Role required: admin

    Create authorization key for the First Advantage spoke

    Create a authorization key to authorise requests from Jenkins.

    Antes de Iniciar

    Role required: admin

    Procedimento

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

    Antes de Iniciar

    Procedimento

    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.

    Antes de Iniciar

    Role required: admin

    Procedimento

    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.

    O que Fazer Depois

    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>.
      Nota:
      • 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.

    Antes de Iniciar

    Role required: First Advantage admin

    Procedimento

    1. Navigate to All > First Advantage Spoke > Accounts.
    2. Click New.
    3. On the form, fill in the values.
      Tabela 5. Account form
      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.

    Resultado

    The First Advantage account and package details are retrieved.
    Nota:
    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.