Create an employer

1 curl -X POST https://test.api.kota.io/employers \ 2 -H "Authorization: Bearer <token>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "legal_name": "foo", 6 "legal_address": { 7 "line1": "foo", 8 "city": "foo", 9 "postal_code": "foo", 10 "country_code": "af" 11 }, 12 "contact": { 13 "name": "foo", 14 "email": "foo" 15 } 16 }'

1 { 2 "id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a", 3 "legal_name": "foo", 4 "legal_address": { 5 "line1": "foo", 6 "city": "foo", 7 "postal_code": "foo", 8 "country_code": "af", 9 "line2": "foo", 10 "line3": "foo", 11 "state": "foo" 12 }, 13 "contact": { 14 "name": "foo", 15 "email": "foo" 16 }, 17 "platform_id": "pt_3b1333d87d9d4fd6ad83ba7f6b0e951a", 18 "status": "pending", 19 "registration_number": "foo", 20 "offboard_on": "foo", 21 "object": "foo" 22 }

Creates an employer.

Request

This endpoint expects an object.

legal_namestringRequired

legal_addressobjectRequired

contactobjectRequired

registration_numberstringOptional

Response

idstringformat: "er_.+"

legal_namestring

legal_addressobject

contactobject

platform_idstringOptionalformat: "pt_.+"

statusenumOptional

Allowed values:

registration_numberstringOptional

offboard_onstringOptionalformat: "date-time"

objectstringOptional

The object type

Headers

Request

Response

Errors