---
updatedAt: 2026-08-04T15:50:34.000Z
agentTools:
  projectIndex: https://docs.spinwheel.io/llms.txt
---

# Network Token

nenona23

# Overview

The Network Token is intended to provide you with the ability to interface with other Spinwheel partners as it relates to passing leads, reducing authentication friction, decreasing costs, and reducing redundant data pulls for a connected user.

## Partner Configuration

All partners using the Network Tokens will be required to have a configuration added to their partner setup to ensure they have access to the specific API functionalities. The Network Token process works on a Producer-Consumer relationship, which ensures that Tokens are not accessible between partners who have not consented to interact with Network Token data.

<Callout icon="📘" theme="info">
  ### Please confirm with your Spinwheel representative which partners you expect to be interfacing with using the Network Token.
</Callout>

## Network Token: User Creation

As a consumer of the Token you will need to follow the API steps outlined [here](https://docs.spinwheel.io/reference/create-network-user). As shown in the API, you will need to provide some user data as confirmation that you have the required consent to connect this user, which means the producer will need to provide some supporting details alongside the Token, such as date of birth, last four digits of the social security number, and an audit object of the user consent date.

Assuming all fields have been provided correctly, the noted API will trigger a user creation for that Network Token and will contain all of the data fields as if the user completed the connect steps above. This user will now be eligible to have a credit report, score, and other features enrolled on the Spinwheel platform under your partner.

<Image src="https://files.readme.io/e040be5e0751fd5edbc1424a7ce518d83ba3e9d94031e568d31618610d7a0c80-Network_Token.jpg" align="center" />

## Network Token: User Creation with Debt Profile Snapshot

Spinwheel offers the ability to connect a user via Network token with their existing Debt Profile data. This follows the same workflow above and [API ](https://docs.spinwheel.io/reference/create-network-user)referenced with the addition of the `include` array.  When noting a `CREDIT_REPORT` there, the successfully connected user will return a snapshot reference of the user's already existing credit report within their Debt Profile.&#x20;

When utilizing the `include` parameter, you will return a `dataStatus.statusCode` - below is the breakdown for potential responses:

| **Code** | `status`  | **Meaning**                                                                                                                                 | **API response example**         |
| -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| **2000** | `SUCCESS` | Response includes `creditReports`, liabilities, and summaries.                                                                              | **Success with credit report**   |
| **4040** | `ERROR`   | User is successfully connected, however no credit report was found for the user.                                                            | **Credit report not found**      |
| **4030** | `ERROR`   | User is successfully connected, however no credit report data was returned. Contact your Spinwheel Representative for Client Configuration. | **Credit bureau not configured** |
| **5000** | `ERROR`   | User is successfully connected, however the credit report failed to return.                                                                 | **Credit report failed**         |