--- title: JustSift API Integration on Truto slug: justsift category: HRIS canonical: "https://truto.one/integrations/detail/justsift/" --- # JustSift API Integration on Truto **Category:** HRIS **Status:** Beta ## MCP-ready AI tools Truto exposes 5 tools for JustSift that AI agents can call directly. - **list_all_just_sift_complex_search_people** — Search justsift people using complex AND/OR filter logic against person fields, with an optional generic text query and field-based sorting. Returns: id, email. Max 100 per page. - **get_single_just_sift_person_by_id** — Get a single person in justsift by their id or email address. Returns the person record including its id and their profile attributes — a mix of standard properties and additional dynamic per-organization fields (the exact key set is listed by the /fields/person route). Required: id. - **list_all_just_sift_search_people** — Perform a simple people search in justsift. Returns a collection of matching people including id, firstName, lastName, pictureUrl, and dynamic per-organization fields. Accepts q plus optional sortBy, sortDirection (asc/desc), orQuery, and exact-match field filters by objectKey (e.g. department=Marketing); filters combine with AND unless orQuery is true. - **list_all_just_sift_people_media** — Retrieve a person's photo from justsift by their id or email. Returns the photo as binary JPEG image data. Required: id_or_email, media_kind. - **list_all_just_sift_person_fields** — List the person profile fields configured in justsift. Returns field definitions including objectKey and searchable; the field list is dynamic per organization. ## How it works 1. **Link your customer's JustSift account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach JustSift.** The Proxy API is a 1-to-1 mapping of the JustSift API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Enrich user profiles with HRIS-grade employee data** — SaaS platforms can mirror JustSift as the source of truth for employee profiles, pulling in enriched attributes like skills, pronouns, and custom fields to avoid asking users to re-enter data already maintained in their directory. - **Power expert discovery and resource routing** — Project management, PSA, and workflow tools can use JustSift's complex search to find employees matching specific skills, departments, or custom tags — enabling intelligent staffing, approvals, or ticket routing based on real org data. - **Render rich people cards inside your product** — Intranets, chat apps, recognition platforms, and CRMs can embed hover cards showing JustSift photos, bios, name pronunciations, and reporting lines whenever an employee is referenced in-app. - **Sync internal talent marketplaces with real skills data** — Internal mobility and L&D platforms can map JustSift's custom person fields to their own schema and pull individual records to pre-populate employee resumes, certifications, and languages for job matching. ## What you can build - **Custom field schema discovery** — Fetch the customer's unique JustSift person field definitions at setup time so your app can dynamically map tenant-specific attributes like certifications or skill taxonomies. - **Advanced employee search with AND/OR filters** — Expose a search UI in your product that runs complex boolean queries against JustSift (e.g. department=Marketing AND skill=Python) to find exactly the right person for a workflow. - **Native avatar and photo rendering** — Pull binary employee photos directly from JustSift to render consistent avatars across org charts, mentions, and user lists without broken image URLs. - **Profile lookup on demand** — Fetch a complete enriched person record by ID when a user clicks a name or mention, powering profile drawers, hover cards, and detail views. - **Lightweight directory filtering** — Use exact-match search to list all employees in a given department, location, or group for picker components, access rules, or segment-based automations. - **Scheduled employee data sync** — Poll JustSift on an interval to keep mirrored user profiles, org structure, and custom attributes fresh inside your application. ## FAQs ### How does authentication work for the JustSift integration? Truto handles the JustSift credential exchange for your end customers through a hosted connect flow, so your app receives a Truto connection ID and never needs to store or refresh JustSift credentials directly. ### Can we read customer-defined custom fields? Yes. The list_all_just_sift_person_fields endpoint returns the tenant's full person field schema, including object keys and whether each field is searchable, so you can map custom attributes dynamically per customer. ### Does Truto support complex searches against JustSift? Yes. list_all_just_sift_complex_search_people lets you run AND/OR queries across standard and custom person fields, which is the recommended path for skill-based or multi-attribute lookups. ### How do we retrieve employee profile photos? Use list_all_just_sift_people_media to pull binary image data for employee avatars, which you can serve directly in your UI without depending on external image URLs. ### Is this integration read-only or does it support writes? The currently exposed tools are read-only — covering person lookup, search, media, and field schema. If you need write operations or additional endpoints, Truto can add them on request. ### How do we keep profile data fresh in our app? JustSift data is kept current via scheduled polling using the search and single-person endpoints. You can run periodic syncs for bulk updates and call get_single_just_sift_person_by_id on demand for real-time lookups triggered by user actions.