Create organization
Create a new organization with default categories and a hiring pipeline.Parameters
The name of the organization
A unique URL-friendly identifier for the organization. Must be unique across all organizations.
Response
Indicates if an error occurred
Success or error message
The created organization object
Default setup
When creating an organization, the following are automatically created:- Default categories: 5 categories in the web version (Software Development, Finance, Operations, HR & Recruiting, Security) or 35 categories in the www version (including Marketing, Sales, Customer Success, Product Management, Design & Creative, and many more)
- Default pipeline (www version only): “General Hiring Pipeline” with stages: Screening, Interview, Technical Task, Final Interview, Offer
- Organization membership: The creator is automatically added as an owner
The exact defaults vary between implementations. Check your specific deployment to see which categories and pipelines are auto-created.
Update organization
Update an organization’s settings.Parameters
The organization object to update
Organization settings to update
Response
Indicates if an error occurred
Success or error message. Returns “Slug Already In Use” if the slug is taken.
Get organization
Retrieve organization details including jobs, categories, and filters.Parameters
The organization’s unique slug identifier
Response
Indicates if an error occurred
The organization object with nested data
Array of unique country locations from jobs
Array of unique employment types from jobs (fulltime, parttime, internship, contract)
Status message