Products
This guide explains which products you need to subscribe to in order to use the Recruitment section of the markee platform, both on workspace level and on employer level.
Workspace Level: Recruitment Module
To enable the Recruitment section for a workspace, an administrator must subscribe to a Recruitment Module product. This product is configured upfront by markee and includes a setting that defines a domain of a markee portal acting as the home for employer pages and job offer pages — this is where all recruitment data gets distributed to.
Once you have received the product ID for your Recruitment Module and your workspace ID, you can subscribe via:
Endpoint: ORDER A Product
You need administrative permissions on the workspace level — specifically the ability to create subscriptions on workspace scope.
Employers
After the Recruitment Module is active on your workspace, all existing companies become potential employers automatically. However, existing companies may require manual attention to be fully set up as employers. Going forward, new employers are created automatically by the system as soon as a company with at least one location is delivered. Consider the employers to be extensions of companies in the markee system.
Employer Level: Recruitment Products
With employers in place, you can subscribe Recruitment products — the markee Jobs products — to individual employers. These products control the ability to publish job offers.
Product Configurations
Recruitment products carry configurations that directly affect how job offers are published and distributed. The following configuration options may be included in a product:
- Available slots — defines how many job offers can be published in parallel under this subscription. See the Job Offer Publishing section for more information.
- Publishing Channel — references a feed from our Feedmanager technology, which controls how the job offer is distributed across the network. Due to the volatile nature of distribution networks and the fact that individual nodes may have further downstream hops that are not publicly disclosed, it is not possible to provide a static list of all platforms on which a given job offer will appear.
- Top Jobs — indicates whether the job offer is shown as a premium (top) listing in markee portal job offer search results.
Pricing & Runtime Settings
Recruitment products can include:
- A setup cost (one-time fee on subscription)
- A cost per item (e.g. monthly fee)
- Runtime settings(optional), which define the subscription lifecycle:
- Renewal cycle — the interval by which the subscription is automatically extended if not cancelled
- Notice period — how far in advance before the end of a cycle you must cancel to prevent renewal
| Action | Endpoint |
|---|---|
| Get the contract for a company / employer | GET Contract List |
| List available products for an employer | GET Product List |
| Subscribe to a product | ORDER A Product |
| Check current subscriptions (incl. next end date) | GET Subscriptions |
markee Jobs has switched to communicating with spaceIds during product ordering. Legacy API calls for companies and locations have been enriched with space IDs, so you can retrieve them from those endpoints whenever needed. Prefer spaceIds field when placing orders.
Addon Products
Recruitment also supports addon products. These work like regular products with one key difference: they must always be booked on top of an existing base subscription.
Addon products appear in the same available products endpoint as regular products (TBD). However, when subscribing to an addon, you must pass the ID of the base subscription it should be attached to in the request body (TBD).
Behavior & Constraints
- Addon products can be cancelled independently from their base subscription.
- The maximum runtime of an addon is bound to its base subscription — it cannot outlive the subscription it is attached to.
- Addons enrich settings of the base product (e.g. increasing the number of available slots for job offer publishing), but they cannot run standalone.
Agency Users vs. Self-Service Users
When using the markee API, your user account type affects which products are visible to you.
- Agency users see the full product catalog by default.
- Self-service users may see a different, potentially limited product list.
It is possible to configure which products are exposed to each user type. If you require a specific configuration for your use case, please reach out to us.