Add Employer

Add a new employer to an existing hosted order when additional employment connections are needed after the order was originally created. The order must not be expired or canceled.

When to use

Scenario	Example
Missing employer	User disclosed an additional employer after initial verification
Seasonal employment	User has a second job that wasn’t initially included

Add an employer [Server-side]

Send a POST request to the order’s /employers/ endpoint with the employer details.

curl --request POST \
     --url https://prod.truv.com/v1/orders/39aa1486ccca4bc19cda071ffc1ba392/employers/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "company_name": "Facebook Demo",
  "company_domain": "facebook.com",
  "start_date": "2019-08-24",
  "company_address": {
    "street": "1 Hacker Way",
    "city": "Menlo Park",
    "state": "CA",
    "zip": "94025"
  }
}'

Request fields

Field	Type	Required	Description
`company_name`	string	No	Employer name
`company_domain`	string	No	Company website domain
`start_date`	date	No	Job start date (YYYY-MM-DD)
`end_date`	date	No	Job end date (YYYY-MM-DD)
`suborder_number`	string	No	Your external ID for tracking
`company_address`	object	No	Employer address with `street`, `city`, `state`, `zip`

The order must be in an active state, not expired or canceled. Check the order status before adding employers.

What happens next

After adding the employer, Truv extends the order to include the new employer. The user receives a notification to connect their additional employer through the hosted verification page. Listen for task-status-updated webhooks to know when the new employer’s data is ready.

Next steps

Data Refresh

Pull updated data without user re-authentication

New User

Create a hosted order from scratch

Deeplinking

Pre-fill employer info to skip search

​When to use

​Add an employer [Server-side]

​Request fields

​What happens next

​Next steps

Data Refresh

New User

Deeplinking

When to use

Add an employer [Server-side]

Request fields

What happens next

Next steps