Create job post location

Attach a location to an existing job_post. The supplied type must match the parent job board's location configuration — boards set to office or custom_list reject free_text values, and a custom_list value must reference a job_board_custom_locations row on the same board as the post. Issue one POST per location to build out a multi-location post; there is no batch create. To replace an existing location, delete the row via DELETE /v3/job_post_locations/{id} and post the new one.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required

Id of the job_post to attach this location to. The post's parent job board must also allow the supplied type — boards configured for office or custom_list locations reject free_text values, and vice versa.

string
enum
required

How the location is sourced. Drives how value is interpreted: free_text treats value as a literal location string, office resolves it to an organization office id, and custom_list resolves it to a job_board_custom_locations id. Must match the parent job board's configured location strategy.

Allowed:
string
required

Location value, interpreted per type. For free_text, the candidate-facing string (e.g. Remote (US)). For office, the integer office id as a string. For custom_list, the integer job_board_custom_locations id as a string — and the custom location must belong to the same job board as the post.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json