---
title: "Create an employer"
method: POST
path: "/employers"
tags: ["Employers"]
---

# Create an employer

`POST /employers`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/employers`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `employers:write`

Create a new employer.

## Request body

- CreateEmployerRequest: Request to create an employer
  - `agencyId` string: Agency ID
  - `idType` 1 | 2 | 3 | 4 | 5 | 6 | 10, required: Employer Identity Type:<br/>1 - עוסק מורשה<br/>2 - חברה פרטית<br/>3 - חברה ציבורית<br/>4 - עמותה רשומה<br/>5 - אגודה שיתופית<br/>6 - שותפות<br/>10 - אחר
  - `idNumber` string, required: ID number
  - `name` string, required: Employer name
  - `street` string: Street address
  - `streetNumber` string: Street number
  - `apartmentNumber` string: Apartment number
  - `mailBox` integer: Mail box number
  - `city` string: City
  - `postalCode` integer: Postal code
  - `country` string: Country
  - `managerId` string: Manager ID

## Response `200`

OK

- EmployerValue
  - `tenantId` string, uuid
  - `agencyId` string, uuid
  - `createdDate` string, date-time
  - `createdBy` string, uuid
  - `creatorName` string
  - `lastModifiedDate` string, date-time
  - `lastModifiedBy` string, uuid
  - `version` integer
  - `id` string, uuid
  - `idType` 'עוסק_מורשה' | 'חברה_פרטית' | 'חברה_ציבורית' | 'עמותה_רשומה' | 'אגודה_שיתופית' | 'שותפות' | 'אחר'
  - `idNumber` string
  - `name` string
  - `street` string
  - `streetNumber` string
  - `apartmentNumber` string
  - `postalBox` integer
  - `city` string
  - `country` string
  - `postalCode` integer
  - `notes` string
  - `notesUpdatedBy` string, uuid
  - `notesUpdatedAt` string, date-time
  - `notesAlert` boolean
  - `misparTikNikuim` string
  - `managerId` string, uuid
  - `managerName` string
  - `tags` string[]
  - `lastActivityDate` string, date-time
  - `lastActivityBy` string, uuid
  - `customFields` SmartDialogFieldValue[]
    - `fieldId` string, uuid
    - `type` integer
    - `value` object
  - `appMailAddress` string

---

[API](https://skmtc.dev/surense/apis/employer-api.md) - [All operations](https://skmtc.dev/surense/apis/employer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/employer-api/revisions/c8564dd956bb?raw)