Revoking a Token

2. Select the desired Data Source from the Data Sources list

📘

The "Status" column in the Data Sources list will indicate if a token has expired or had been previously revoked.

3. Click on "More Actions" then "Revoke Token" in the top right

4. Click "Yes, Revoke It!" in the resulting fly-over window

Create a New Token

5. Click on "Create Token" after clicking on "More Actions" in the top right

6. You will automatically be redirected to a page where you are asked to:

• choose an account to continue with NinjaCat select a user account that has access to the service provider data that needs to be connected to NinjaCat
• log in with the required credentials
• confirm the listed permissions

7. If prompted, click the confirmation step within the data provider-specific page

8. Click "Save Network" in the bottom right of the Network Settings page

Restoring an expired data source connection

Data source connections that use OAuth (for example Google Ads, Meta, and Search Ads 360) can expire. When a connection's token has expired, affected widgets show blank data or a "Getting Data (0 of 1)" state instead of results.

There are two distinct ways to update a connection's credentials, depending on who will re-enter them:

Request new credentials from the client (send a secure link)
Use this when the person who holds the login for the data source (often your client) needs to re-authenticate. From the data source's More Actions menu, choose Request new credentials from client. This generates a single-use link, valid for 24 hours, that you send to the client; they open it and re-enter their credentials to restore access — without needing a NinjaCat login.

Edit the connection
Editing a connection lets your agency rename it and manage which agents have access (permissions) — it does not let the agency type in the client's credentials. Credential secrets are only entered by the client (through the secure link described above) or via the provider's OAuth sign-in.

To request new credentials from the client:

1. Open Setup Settings and select the affected data source from the Data Sources list. The Status column indicates when a token has expired or been revoked.
2. Click More Actions → Request new credentials from client.
3. Send the generated single-use link (valid for 24 hours) to the person who holds the data source login.
4. Once they complete the credential entry through the link, confirm the connection returns to a healthy state and the affected widgets repopulate.

Which path to choose: use Request new credentials from client to have the client re-enter expired credentials via a secure link. Use Edit to rename the connection or manage agent access permissions — Edit does not re-enter or update credential secrets.