> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Employer

> Add a new employer to an existing order after it has been created

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

```mermaid theme={null}
sequenceDiagram
    participant Server as Your Server
    participant API as Truv API
    participant Bridge as Truv Bridge

    Server->>API: Add employer (POST /v1/orders/{id}/employers/)
    API-->>Server: New employer added to order
    API->>Bridge: User receives notification
    Bridge->>Bridge: User connects new employer
    API-->>Server: Webhook (task-status-updated, done)
```

***

## 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.

```bash theme={null}
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` |

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

***

## What happens next

After adding the employer, Truv extends the order to include the new employer. The user receives a notification (if configured) to connect their additional employer through Bridge. Listen for `task-status-updated` webhooks to know when the new employer's data is ready.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Data Refresh" icon="arrows-rotate" href="/developers/integration/embedded-orders/data-refresh">
    Pull updated data without user re-authentication
  </Card>

  <Card title="Follow-up" icon="bell" href="/developers/integration/embedded-orders/follow-up">
    Re-engage users who didn't finish verification
  </Card>

  <Card title="Self-Certification" icon="clipboard-check" href="/developers/integration/embedded-orders/self-certification">
    Let users review and confirm retrieved data
  </Card>
</CardGroup>