---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the GovNotify spoke

# Set up the GovNotify
spoke {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Integrate ServiceNow instance and GovNotify account using JWT
authentication to authenticate ServiceNow requests.

## Before you begin

* Request an Integration Hub subscription.
* Activate the GovNotify spoke.
* Role required: admin.
{#govnotify-setup__ul_lyq_rhc_5rb}

## Procedure

1. In the GovNotify account, create an API key.
   1. Log in to your GovNotify account as admin.
   2. Navigate to API integration and click API Keys.
   3. Click Create an API key.
   4. On the form, provide a name for the API key and select the required key type.  
   5. Click Continue.  
      The API key is displayed in this format: <kbd class="ph userinput">{key_name}-{iss-uuid}-{secret-key-uuid}</kbd>. For example, if the API key is <kbd class="ph userinput">my_test_key-26785a09-ab16-4eb0-8407-a37497a57506-3d844edf-8d35-48ac-975b-e847b4f122b0</kbd>:
      * API key name is: <kbd class="ph userinput">my_test_key</kbd>
      * iss (service id) is: <kbd class="ph userinput">26785a09-ab16-4eb0-8407-a37497a57506</kbd>
      * secret key or signing key is: <kbd class="ph userinput">3d844edf-8d35-48ac-975b-e847b4f122b0</kbd>

      {#govnotify-setup__ul_fzy_l4c_5rb}For more information, see [Headers](https://docs.notifications.service.gov.uk/rest-api.html#headers) in [GovNotify REST API
      documentation](https://docs.notifications.service.gov.uk/rest-api.html#rest-api-documentation).
   6. Click Copy API key to clipboard and record the value for later use.  
   {#govnotify-setup__substeps_vjd_xlc_5rb}
2. Configure the default JWT key record in your ServiceNow instance.
   1. Navigate to System OAuthJWT Keys.
   2. Open the record, GovNotify Key.
   3. Enter the signing key you had copied from the API key in Signing key.
   4. Click Update.
   {#govnotify-setup__substeps_p4w_4lc_5rb}
3. Configure the default JWT provider record in your ServiceNow instance.
   1. Navigate to System OAuthJWT Providers.
   2. Open the record, GovNotify JWT Provider.
   3. In the Standard claims tab, click the iss record.
   4. Enter the iss (service id) value you had copied from the API key in Claim value.
   5. Click Update.
   {#govnotify-setup__substeps_ulv_bqc_5rb}
4. Configure the default credential record in your ServiceNow instance.
   1. Navigate to GovNotify SpokeCredentials.
   2. Open the record, GovNotify Cred.
   3. For JWT Provider, select the JWT provider you had configured.
   4. Click Update.
   {#govnotify-setup__substeps_vgb_fxc_5rb}
5. Configure the default connection and credential alias record in your ServiceNow instance.
   1. Navigate to Connections \& CredentialsConnection \& Credential Aliases.
   2. Open the record, GovNotify.
   3. In the Connections tab, click New.
   4. On the form, fill these values.  
      {#govnotify-setup__table_fqb_5xc_5rb__entry__2}

      | Field | Description |
      |-|-|
      | Credential | Credential record you had configured. For example, <kbd class="ph userinput">GovNotify Cred</kbd>. |
      | Connection URL | URL to connect to GovNotify account. Enter <kbd class="ph userinput">https://api.notifications.service.gov.uk</kbd>. |
      [Table 1. HTTP(s) Connection form]

      {#govnotify-setup__table_fqb_5xc_5rb}
   5. Click Submit.
   {#govnotify-setup__substeps_yrz_lxc_5rb}
{#govnotify-setup__steps_td2_nlc_5rb}

*[\>]: and then