## Upload a new document

`client.documents.create(DocumentCreateParamsbody, RequestOptionsoptions?): Document`

**post** `/documents`

Create a new document with file content

### Parameters

- `body: DocumentCreateParams`

  - `file: Uploadable`

    The document file to upload

  - `household_id: string`

    Household ID this document belongs to

  - `name: string`

    Display name of the document

  - `type: DocumentType`

    Type of document

    - `"GRAT_DESIGN_SUMMARY"`

    - `"GENERATED_PRESENTATION"`

    - `"ASSET_VALUATION"`

    - `"SIGNED_TRUST_DOCUMENT"`

    - `"TRUST_AMENDMENT"`

    - `"TRANSFER_CONFIRMATION"`

    - `"EXISTING_REMAINDER_TRUST_DOCUMENT"`

    - `"BALANCE_SHEET"`

    - `"WILL"`

    - `"WILL_CODICIL"`

    - `"POWER_OF_ATTORNEY"`

    - `"ASSIGNMENT_OF_INTEREST"`

    - `"ASSIGNMENT_OF_TANGIBLE_PROPERTY"`

    - `"LOAN_NOTE_AGREEMENT"`

    - `"ARTICLES_OF_INCORPORATION"`

    - `"OPERATING_AGREEMENT"`

    - `"PARTNERSHIP_AGREEMENT"`

    - `"ACCOUNT_DOCUMENTATION_STATEMENT"`

    - `"TAX_ID_CONFIRMATION"`

    - `"GIFT_TAX_RETURN"`

    - `"INCOME_TAX_RETURN"`

    - `"TAX_RECEIPT"`

    - `"TAX_FILING"`

    - `"CORPORATE_BYLAWS"`

    - `"LLC_AGREEMENT"`

    - `"LLC_AGREEMENT_AMENDMENT"`

    - `"OPERATING_AGREEMENT_AMENDMENT"`

    - `"PARTNERSHIP_AGREEMENT_AMENDMENT"`

    - `"SHAREHOLDERS_AGREEMENT"`

    - `"STATE_BUSINESS_FILING"`

    - `"LOGGED_CONTRIBUTION"`

    - `"LOGGED_DISTRIBUTION"`

    - `"INSURANCE_POLICY"`

    - `"CRUMMEY_LETTER"`

    - `"INSURANCE_PREMIUM_PAYMENT"`

    - `"BENEFICIAL_OWNERSHIP_INFORMATION_REPORT"`

    - `"FINCEN_FILING"`

    - `"HEALTHCARE_PROXY"`

    - `"LIVING_WILL"`

    - `"DRIVERS_LICENSE"`

    - `"PASSPORT"`

    - `"DEED"`

    - `"OTHER"`

  - `enable_ai_suggestions?: boolean`

    Whether this document should be used for AI suggestions

  - `entity_id?: string`

    Entity ID if this document is owned by an entity

  - `individual_id?: string`

    Individual ID if associated with an individual

### Returns

- `Document`

  - `id: string`

    Unique identifier with document_ prefix

  - `created_at: string`

    Timestamp when the document was created

  - `household_id: string`

    Household ID this document belongs to

  - `name: string`

    Display name of the document

  - `type: DocumentType`

    Type of document

    - `"GRAT_DESIGN_SUMMARY"`

    - `"GENERATED_PRESENTATION"`

    - `"ASSET_VALUATION"`

    - `"SIGNED_TRUST_DOCUMENT"`

    - `"TRUST_AMENDMENT"`

    - `"TRANSFER_CONFIRMATION"`

    - `"EXISTING_REMAINDER_TRUST_DOCUMENT"`

    - `"BALANCE_SHEET"`

    - `"WILL"`

    - `"WILL_CODICIL"`

    - `"POWER_OF_ATTORNEY"`

    - `"ASSIGNMENT_OF_INTEREST"`

    - `"ASSIGNMENT_OF_TANGIBLE_PROPERTY"`

    - `"LOAN_NOTE_AGREEMENT"`

    - `"ARTICLES_OF_INCORPORATION"`

    - `"OPERATING_AGREEMENT"`

    - `"PARTNERSHIP_AGREEMENT"`

    - `"ACCOUNT_DOCUMENTATION_STATEMENT"`

    - `"TAX_ID_CONFIRMATION"`

    - `"GIFT_TAX_RETURN"`

    - `"INCOME_TAX_RETURN"`

    - `"TAX_RECEIPT"`

    - `"TAX_FILING"`

    - `"CORPORATE_BYLAWS"`

    - `"LLC_AGREEMENT"`

    - `"LLC_AGREEMENT_AMENDMENT"`

    - `"OPERATING_AGREEMENT_AMENDMENT"`

    - `"PARTNERSHIP_AGREEMENT_AMENDMENT"`

    - `"SHAREHOLDERS_AGREEMENT"`

    - `"STATE_BUSINESS_FILING"`

    - `"LOGGED_CONTRIBUTION"`

    - `"LOGGED_DISTRIBUTION"`

    - `"INSURANCE_POLICY"`

    - `"CRUMMEY_LETTER"`

    - `"INSURANCE_PREMIUM_PAYMENT"`

    - `"BENEFICIAL_OWNERSHIP_INFORMATION_REPORT"`

    - `"FINCEN_FILING"`

    - `"HEALTHCARE_PROXY"`

    - `"LIVING_WILL"`

    - `"DRIVERS_LICENSE"`

    - `"PASSPORT"`

    - `"DEED"`

    - `"OTHER"`

  - `updated_at: string`

    Timestamp when the document was last updated

  - `enable_ai_suggestions?: boolean`

    Whether this document should be used for AI suggestions

  - `entity_id?: string | null`

    Entity ID if this document is owned by an entity

  - `individual_id?: string | null`

    Individual ID if this document is associated with an individual

### Example

```typescript
import fs from 'fs';
import Luminary from 'withluminary';

const client = new Luminary();

const document = await client.documents.create({
  file: fs.createReadStream('path/to/file'),
  household_id: 'household_01ARZ3NDEKTSV4RRFFQ69G5FAV',
  name: 'Trust Agreement.pdf',
  type: 'GRAT_DESIGN_SUMMARY',
});

console.log(document.id);
```

#### Response

```json
{
  "id": "document_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "created_at": "2024-01-15T09:30:00Z",
  "household_id": "household_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "name": "Trust Agreement.pdf",
  "type": "GRAT_DESIGN_SUMMARY",
  "updated_at": "2024-01-20T14:45:00Z",
  "enable_ai_suggestions": true,
  "entity_id": "entity_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "individual_id": "client_profile_01ARZ3NDEKTSV4RRFFQ69G5FAV"
}
```