Upsert Job | JobGorilla | Documentation

Publish a new Job or update an existing Job.

Request

This endpoint expects an object.

idstringRequired

Unique identifier for this job posting in your system

titlestringRequired<=1000 characters

Job title or position name

descriptionstringRequired50-10000 characters

Detailed job description including responsibilities, requirements, and qualifications

applyUrlstringRequiredformat: "uri"

URL where candidates can apply for this position

contactobjectRequired

Primary contact information for this job posting

companyobjectRequired

Company or organization offering this position

locationobjectRequired

Primary work location for this position

openingsintegerRequired1-999

Number of available positions for this job posting

placementTypeenumRequired

Type of employment arrangement

currencyenumRequired

Currency for compensation values

payTypeenumRequired

Payment frequency for compensation

openDatedatetimeRequired

Date when this job posting becomes active and visible

enableIndeedApplybooleanRequiredDefaults to true

Enable Indeed Apply integration for this posting

enableZipRecruiterApplybooleanRequiredDefaults to true

Enable ZipRecruiter Apply integration for this posting

postingIdstringOptional

Alternative or external posting identifier (e.g., from ATS or job board)

workFromHomebooleanOptionalDefaults to false

Indicates if this position allows work from home

workRemotebooleanOptionalDefaults to false

Indicates if this is a fully remote position

workHybridbooleanOptionalDefaults to false

Indicates if this position offers hybrid work arrangements

partTimebooleanOptionalDefaults to false

Indicates if this is a part-time position

maxPaydoubleOptional>=0

Maximum pay rate or salary based on payType

minPaydoubleOptional>=0

Minimum pay rate or salary based on payType

endDatedatetimeOptional

Date when this job posting expires and should be removed

screenerQuestionsUrlstringOptionalformat: "uri"

URL to pre-screening questions or assessment for applicants

Response

Job successfully created or updated

jobGorillaGuidstring

The JobGorilla GUID created when the job was created.

statusenum

The status of the request.

errorslist of strings

Any errors to help with troubleshooting a problem.

Errors

400

Bad Request Error

$	curl -X POST https://feed.jobgorilla.com/job \
>	-H "X-JobGorilla-Key: X-JobGorilla-Key" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"id": "JOB-2024-001234",
>	"title": "Senior Software Engineer",
>	"description": "We are seeking a Senior Software Engineer to join our team to develop scalable web applications and lead technical projects. Candidates should have 5+ years of experience in software development, a BS",
>	"applyUrl": "https://company.com/careers/apply/job-123",
>	"contact": {
>	"email": "hr@techinnovators.com"
>	},
>	"company": {
>	"id": "COMP-78910",
>	"name": "Tech Innovators Inc.",
>	"location": {
>	"stateCode": "CA",
>	"countryCode": "US"
>	},
>	"directEmployer": true
>	},
>	"location": {
>	"stateCode": "CA",
>	"countryCode": "US"
>	},
>	"openings": 3,
>	"placementType": "CONTRACT",
>	"currency": "USD",
>	"payType": "HOURLY",
>	"openDate": "2024-01-15T09:00:00Z",
>	"enableIndeedApply": true,
>	"enableZipRecruiterApply": true
>	}'

1	{
2	"jobGorillaGuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3	"status": "OK",
4	"errors": []
5	}

Headers

Request

Response

Errors