Application employment

Add an employment entry

Records a job the applicant holds or held and returns the new entry. Requires the rental_applications:write permission.

POST

https://services.magicdoor.com/leasing/company-portal/rental-applications/{applicationId}/employment

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

applicationIdstringrequired

The rental application to work with. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Body

application/json

Every field is optional.

namestring

Employer name. At most 250 characters.

phonestring

Employer phone number.

salarynumber

Annual salary for this job, as a decimal amount, for example 72000.00.

jobTitlestring

The applicant's job title. At most 250 characters.

startDatestring · date

First day at this employer, as YYYY-MM-DD.

endDatestring · date

Last day at this employer, as YYYY-MM-DD. Leave it out while the job is current.

commentstring

Free-text note. At most 500 characters.

Response

200 · The new employment entry. `files` is always empty here — documents are attached separately.

idstring

The employment entry.

namestring

Employer name. Absent when the applicant did not give one.

phonestring

Employer phone number.

salarynumber

Annual salary the applicant stated for this job, as a decimal amount, for example 72000.00.

jobTitlestring

The applicant's job title.

startDatestring · date

First day at this employer.

endDatestring · date

Last day at this employer. Absent while the job is current.

commentstring

Free-text note stored with the entry.

filesFile[]

Documents attached to this employment entry, such as pay stubs. Empty when none.

createdstring · date-time

When the entry was added, in the company's timezone.

updatedstring · date-time

When the entry was last changed, in the company's timezone.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:write` permission.

404 · No rental application with this id exists, or it belongs to another company. Both cases look identical so that ids cannot be probed across companies.

Allowed in every application status

This is not gated on the application's status — it works on a draft, on a submitted application, and on a retracted one. Only the applicant-facing portal locks an application once it is submitted.

Salary feeds the missing-documents check

When the income the applicant states on the application is far above the salaries on their current jobs, the application is flagged in the missingDocs bucket on List rental applications.