Skip to main content
Pre-fill employer or provider information when creating a bridge token to bypass the search screens. Use this for DDS and PLL flows where you already know the user’s employer or provider.
For Embedded Orders deeplinking (VOIE, VOE, VOA), see Deeplinking for Embedded Orders.
Use this when you know the user’s employer name. Truv maps the employer to the correct payroll provider automatically.

​
Find the company mapping

curl --request GET \
     --url 'https://prod.truv.com/v1/company-mappings-search/?query=Facebook' \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET'

[
  {
    "company_mapping_id": "48427a36d43c4d5aa6324bc06c692456",
    "name": "Facebook",
    // ...
  }
]

​
Create a bridge token with the mapping

Pass the company_mapping_id when creating the bridge token. 
curl --request POST \
     --url https://prod.truv.com/v1/users/USER_ID/tokens/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "product_type": "deposit_switch",
  "company_mapping_id": "48427a36d43c4d5aa6324bc06c692456"
}'
The user skips the employer search screen and lands directly on the provider login page.
Use this when you know the specific payroll provider (e.g. ADP, Workday, Gusto) but not the specific employer. 
curl --request POST \
     --url https://prod.truv.com/v1/bridge-tokens/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "product_type": "deposit_switch",
  "provider_id": "adp",
  "user": {
    "id": "99dd17074ac94aa9ace2621d657c7610"
  }
}'
All providers from the List all data providers endpoint are supported as deeplink targets.

​
Next steps

Search Companies

Find company_mapping_id by employer name

List Providers

All supported provider_id values

Bridge Token API

Create bridge tokens with deeplink parameters

Embedded Orders Deeplinking

Deeplinking for VOIE, VOE, and VOA flows