The metadata endpoint Get all company fields now retrieves metadata for all employee fields, without requiring any permissions for the service user performing this action.

This update allows developers to seamlessly fetch all field metadata using the API, regardless of category permissions. This way, even if fields are moved between categories, developers can still view the field's category and guide the Admin on which categories the service user needs access to for fetching the actual field data.

To learn more about permissions, see API Service Users.

Field metadata sample:

    {
        "id": "personal.age",
        "category": "personal",
        "name": "Age",
        "description": null,
        "jsonPath": "personal.age",
        "type": "number",
        "typeData": {},
        "historical": false
    },

Changelog provides a list of all changes to the API, including new features and deprecations so you can effortlessly keep track of the latest updates and enhancements.

You can subscribe to the RSS feed, which will notify you whenever a new post in the Changelog is published. This ensures you’re always in the loop with the latest developments.

To get notified about new updates subscribe to the changelog RSS feed using your application of choice (Slack, Outlook, Chrome extension, etc.).

We have updated our documentation to include rate limits for all API endpoints

What has changed:

• Detailed rate limits: each section in the reference guide now includes a main page which displays the rate limits for all endpoints in that section. This helps you understand the usage limits and plan your API calls accordingly.
• Rate limits headers: we've included details about HTTP response header which provide real-time information about your current usage and remaining quota.
• Best practices section: we've added a best practices section with general instructions on how to manage rate limits effectively. This includes tips on optimizing your API usage to stay within the limits and avoid potential issues.

To learn more, see Rate limiting.

We are pleased to announce that Bob’s Webhooks now support Time Off events.

Webhooks are a way for Bob to communicate with other applications automatically. When a specific event occurs in Bob, a webhook sends real-time data to the other application through an HTTP request. This enables seamless integration and automation between different systems.

Benefits:

• Real-Time updates: Webhooks provide instant notifications about changes, allowing your application to react immediately.
• Automation: Reduce manual tasks by automating workflows based on specific events.
• Efficiency: Streamline processes by integrating systems and reducing the need for frequent API calls to check for updates.

Supported Time Off Events:

• Approved: Get notified when a time off request is approved.
• Declined: Receive updates when a time off request is declined.
• Canceled: Know immediately when a time off request is canceled.
• Deleted: Be informed when a time off request is deleted.
• Updated: Get informed when a time off request is updated.
• Submitted: Receive notifications when a time off request is submitted.
• Created from Import: Stay updated when time off requests are created through imports.

These new webhook events help you keep your systems synchronized and ensure you have up-to-date information about employee time off statuses. To learn more, see Time off Webhooks events.

To learn more, see Time off Webhook events.

You can now retrieve specific table data for up to 200 different employees in a single API call.

Benefits:

• Optimized data retrieval: this enhancement allows you to obtain the necessary data in a consolidated and optimized manner, reducing the need for multiple API requests and improving performance.
• Improved efficiency: by retrieving data in bulk, you can streamline your processes and reduce the load on your API calls.

Pagination Support:

• Efficient data management: endpoints that perform bulk read also support pagination, which helps in managing large datasets by breaking them into smaller, more manageable chunks. This improves performance and makes data handling more efficient. To learn more, see Pagination in Bob’s API.

Supported endpoints:

• List work history for a list of employees.
• List the lifecycle history for a list of employees.
• List employment history for a list of employees.
• List payroll history (salaries) for a list of employees.

We are pleased to announce the release of Bob's Hiring API, designed to enhance your recruitment process.

With Bob Hiring you can promote job openings, build your candidate pipeline, and send offers. With Bob's Hiring API you can fetch the job ads from Bob's careers page and post them to your custom careers page.

Key Features:

• Fetch job ads: retrieve job ads from Bob's careers page and post them to your custom careers page.
• Application form links: get a link to an application form for new candidates to apply for the job.

Highlights:

• Efficient job ads management: fetch lists and details of job ads.
• Custom career page integration: create corresponding pages on your career site for each job ad retrieved.
• Easy application process: utilize the 'applyUrl' field in the job ad to link directly to Bob-hosted application forms and streamline adding applicants to Bob.

To learn more about how to set up the integration, see Integrate your custom careers page with Bob Hiring.

For more detailed instructions for developers, see the Hiring reference guide

We have made some changes to the reference guide menus to improve navigation and clarity.

• People endpoints update: the "People" section now includes only the endpoints for the entire "employee" record or basic "fields" (not tables).
• Employee Tables: all other people APIs, which access employee tables, have been moved to the new "Employee Tables" section.
• Main page for each category: each category now has a main page that includes basic information about accessing these endpoints and their rate limits.

These enhancements aim to provide a more organized and user-friendly experience.

🚧

As of July 31st, 2024, we will be discontinuing the Read my tasks endpoint

This change is part of our ongoing efforts to enhance security and streamline our API authentication methods. It may require some adjustments on your end, but the good news is that we have already prepared an alternative endpoint that can replace the functionality of the discontinued endpoint: Read tasks of a specific employee. This endpoint will provide you with similar functionality to the one you are currently using.

What do you need to do?

We recommend updating your code to use this endpoint before the discontinuation date to avoid any disruption in your services. If you have any questions or need further assistance, please contact our support team.

We've enhanced our document management capabilities with new endpoints. Previously, you could manage documents in either an employee's confidential or shared folders. Now, you have the flexibility to manage documents across all of an employee's folders.

The new endpoints include:

• Upload a document to an employee's custom folder
• Upload a file to an employee's custom folder
• Delete a specific document from an employee's custom folder

These new features provide more control and flexibility in managing employee documents. If you have any questions or need further assistance, please contact our support team.

❗️

Effective October 31, 2024 the "API Access Token" authentication method will be discontinued.

Starting October 31, 2024, we will exclusively support the API Service Users method for API authentication. This change is a step towards strengthening security measures and ensuring a more robust and reliable service for all our users.

What do you need to do?

• By June 15, 2024: Ensure you do not create any new API Tokens, as it will no longer be possible. Please incorporate this change into your processes. You can continue to manage existing tokens until October 31, 2024.
• By October 31, 2024: Transition fully to the API Service Users method for API authentication.

Please ensure you update your systems and processes accordingly. If you have any questions or need further assistance, feel free to contact our support team.