---
title: "Personal Details"
method: POST
path: "/companies/{company}/components/team_setup/personal_details"
---

# Personal Details

`POST /companies/{company}/components/team_setup/personal_details`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/companies/{company}/components/team_setup/personal_details`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/companies/:company/components/team_setup/personal_details/post.ts> (a function with typed inputs; its response is checked against the schema)

This Component allows an employer admin to provide a single employee's or contractor's tax identification number and address. An employee or individual contractor provides an SSN and date of birth; a business contractor provides an EIN. It is the "Personal details" screen of the team setup profile dialog, available as a standalone Component.

## Path parameters

- `company` string, required

## Request body

- object
  - `signer_name` string: The name of the person who has permission to onboard on behalf of the company.
  - `signer_title` string: The title of the person who has permission to onboard on behalf of the company (e.g. "Officer", "Manager", etc.).
  - `email` string: The email of the person who has permission to onboard on behalf of the company
  - `signatory` string: The ID of the signatory object for this company. You may use either a signatory ID or the three body params above
  - `employee` string: ID of the employee whose personal details screen to open. Provide exactly one of `employee` or `contractor`.
  - `contractor` string: ID of the contractor whose personal details screen to open. Provide exactly one of `employee` or `contractor`.

## Response `200`

200

- object
  - `url` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/companies/:company/components/team_setup/personal_details/post.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)