Cloud-based human capital management software covering Employee Central, Recruiting, Performance & Goals, Learning, Compensation, and more.
Cloud-based human capital management software covering Employee Central, Recruiting, Performance & Goals, Learning, Compensation, and more. On Nagent, SAP SuccessFactors is exposed as a fully-configurable human resources integration that any agent can call — 64 actions, and SAML authentication. No code is required to wire SAP SuccessFactors into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use SAP SuccessFactors to automate the kinds of tasks human resources teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire SAP SuccessFactors into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against SAP SuccessFactors, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SAP_SUCCESSFACTORS_APPROVE_CALIBRATION_SESSIONFinalize a calibration session that is in the In Progress or Approving status.
Input parameters
Optional comments for the approval
The calibration session ID to approve/finalize
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_CREATE_A_FEEDBACK_REQUESTCreate a feedback request in SAP SuccessFactors Continuous Feedback. Use when you need to request performance feedback from one employee about another. At least one question must be provided.
Input parameters
Topic or title of the feedback request. Describes what the feedback is about.
First feedback question. At least one question must be provided. Questions must be in order (cannot skip question1 if providing question2 or question3).
Second feedback question. Can only be provided if question1 is also provided. Questions must be in order.
Third feedback question. Can only be provided if both question1 and question2 are provided. Questions must be in order.
Optional additional text or context for the feedback request. Note: This field is not supported by the SAP SuccessFactors API and will be ignored.
Assignment UUID of the recipient (the person who will provide the feedback). This is who will be asked to provide feedback.
Assignment UUID of the requester (must be the authenticated user). This is the person requesting the feedback.
Assignment UUID of the subject user (the person the feedback is about). This is who the feedback will be about.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_CREATE_LEARNING_ACTIVITIES_BULKCreate learning activities and associate them with development goals in bulk (requires third-party LMS integration).
Input parameters
List of learning activities to create (requires third-party LMS integration)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_CREATE_ONBOARDEECreates a new onboardee in SAP SuccessFactors Onboarding 2.0 system. Use when initiating the onboarding process for a new hire or rehire. Requires admin create user permissions.
Input parameters
The email address of the onboardee. Must be a valid email format.
The user ID for the onboardee. This is a unique identifier for the user in the system.
Password for the onboardee account. Must meet the system's password requirements.
The username for the onboardee. This will be used as the login identifier.
Indicates if this is a new hire. Expected values: 'Yes' or 'No'. If not provided, system defaults will apply.
The application ID for the onboarding process. This identifies which onboarding workflow to use.
Identifies if the person is a rehire. Set to true to find and link to old employment record in the system.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_CREATE_UPDATE_SUCCESSOR_NOMINATIONCreate or update a successor nomination for a position or talent pool in succession planning. Use when you need to nominate or update a successor for a specific position or talent pool.
Input parameters
Optional notes or comments about the nomination.
The ranking of the successor nominee. Used when multiple successors are nominated for the same position or pool.
The user ID of the nominee to be added or updated in the nomination.
The readiness level of the successor nominee. Typically a numeric value indicating how ready the person is for the role.
Indicates if the nominee is designated as emergency cover for the position.
Position code or talent pool identifier for the nomination target.
Indicates if this is a talent pool nomination. Set to false for position-based nominations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_DELETE_NOMINATION_POSITION_TALENT_POOLDelete a nomination for a position or talent pool in succession planning. Use when you need to remove a nominee from a position or talent pool nomination.
Input parameters
The user ID of the nominee to be removed from the nomination.
Position code or talent pool identifier for the nomination target.
Indicates if this is a talent pool nomination. Set to false for position-based nominations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_APPLICATION_INTERVIEWRetrieves interview information related to job applications from Interview Central. Use when you need to query interview schedules, statuses, or details for applicants. Note: This entity checks only the first 1000 records, so filtering by applicationId is recommended.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter)
OData $filter expression to filter interviews. Important: This entity checks only the first 1000 records, so filtering by specific applicationId or job requisition ID is recommended for complete data retrieval.
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_BACKGROUND_EDUCATIONTool to retrieve background education records for employees from SAP SuccessFactors. Use when you need to query education history with support for filtering, field selection, and pagination via OData query options. Background entities use backgroundElementId as the unique key field.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
Navigation properties to expand (OData $expand)
OData $filter expression to filter education records (e.g., "userId eq 'jdoe'" or "school eq 'MIT'")
Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_BACKGROUND_MOBILITYRetrieves mobility background records showing employee willingness to relocate. Use when you need to query employee geographic mobility preferences and location data. Results can be filtered and ordered by bgOrderPos to maintain screen display order.
Input parameters
Maximum number of records to return (OData $top parameter). Default is 100.
Number of records to skip for pagination (OData $skip parameter). Use with $top for pagination.
Navigation properties to expand (OData $expand parameter)
OData $filter expression to filter mobility records (e.g., "userId eq '12345'" or "bgOrderPos eq 1")
Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned.
OData $orderby expression for sorting results. Example: bgOrderPos asc or startDate desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CALIBRATION_SESSION_BY_IDGet a specific calibration session by session ID.
Input parameters
Navigation properties to expand (OData $expand)
Comma-separated list of fields to retrieve (OData $select)
The calibration session ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CALIBRATION_SESSIONSQuery all the calibration sessions that a user can access.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
OData $filter expression to filter sessions
Comma-separated list of fields to retrieve (OData $select)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CALIBRATION_SUBJECT_BY_IDQuery a specific subject's competency ratings and ratings within a calibration session.
Input parameters
Navigation properties to expand (OData $expand)
Comma-separated list of fields to retrieve (OData $select)
The calibration session ID
The subject ID to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CALIBRATION_SUBJECT_RATINGSQuery a subject's ratings, competency ratings, and comments by using session ID.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
OData $filter expression to filter subjects
Comma-separated list of fields to retrieve (OData $select)
The calibration session ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CDP_LEARNING_METADATAGet metadata for Career Development Planning Learning service.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CURRENT_USERRetrieves the currently authenticated user's information from SAP SuccessFactors.
Input parameters
Comma-separated list of fields to retrieve via OData $select parameter
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_CUSTOM_MDF_OBJECTTool to retrieve custom MDF (Metadata Framework) objects from SAP SuccessFactors. Custom object names begin with cust_ prefix in the API. Use when you need to query custom business objects defined in the MDF framework.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
Navigation properties to expand (OData $expand), such as createdByNav, lastModifiedByNav, externalCodeNav
OData $filter expression to filter custom MDF object records
Comma-separated list of fields to retrieve via OData $select parameter
The name of the custom MDF object (without cust_ prefix). Example: COVID_19_VACCINE_TRACKING, EmpLetterRequest, HEALTH_STATUS_TRACKING
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_EMP_EMPLOYMENT_TERMINATIONRetrieves employee termination information records from SAP SuccessFactors. Contains details about employment terminations including termination date and reason. Use when you need to query termination records with support for filtering, field selection, expansion of related entities, and pagination via OData query options.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
Navigation properties to expand via OData $expand parameter (e.g., "jobInfoNav" to include job information)
OData $filter expression to filter termination records (e.g., "userId eq '12345'" or "endDate ge datetime'2024-01-01T00:00:00'")
Comma-separated list of fields to retrieve via OData $select parameter. If not specified, all fields are returned.
OData $orderby expression for sorting results (e.g., "endDate desc" or "userId asc")
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_EMPLOYEE_TIMERetrieves employee time entries including time off records from SAP SuccessFactors. Use when you need to query approved leaves, time-off requests, or employee time tracking data. Supports filtering by userId, approvalStatus, timeType, and date ranges.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
OData $filter expression to filter employee time entries. Common filters include userId eq 'value', approvalStatus eq 'APPROVED', timeType eq 'value', startDate ge datetime'2024-01-01T00:00:00'
Comma-separated list of fields to retrieve via OData $select parameter
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_EMPLOYEE_TIMESHEETRetrieves employee timesheet records for attendances, overtime, on-call times, and allowances. Use when you need to query employee timesheet data from SAP SuccessFactors.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Expand related entities to include in the response (OData $expand parameter). Common navigations: userIdNav, employeeTimeSheetEntry, allowance
OData $filter expression to filter timesheet records. Use OData query syntax (e.g., "userId eq 'user123'" or "startDate ge datetime'2024-01-01T00:00:00'")
Response format (json or xml). Defaults to json
Comma-separated list of fields to include in the response (OData $select parameter)
OData $orderby expression for sorting results. Specify field name and optionally 'asc' or 'desc'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_EMP_PAY_COMP_NON_RECURRINGTool to retrieve non-recurring pay component information including bonuses and one-time payments from SAP SuccessFactors. Use when you need data about employee bonuses, commissions, or other non-recurring compensation components.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
Navigation properties to expand via OData $expand parameter
OData $filter expression to filter non-recurring pay component records (e.g., userId eq 'cgrant', payDate eq datetime'2024-01-15T00:00:00')
Comma-separated list of fields to retrieve (e.g., userId,seqNumber,payComponentCode,amount,currency,payDate)
OData $orderby expression for sorting results (e.g., payDate desc)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_EMP_PAY_COMP_RECURRINGTool to retrieve recurring pay component information including salary and benefits data from SAP SuccessFactors. Use when you need to query employee compensation data with recurring payments such as salary, allowances, or benefits. Supports filtering by userId and payComponent code.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
Navigation properties to expand via OData $expand parameter
OData $filter expression to filter recurring pay component records. Typically filter by userId eq 'value' and payComponent eq 'code' (e.g., userId eq 'extuser1' and payComponent eq 'CAR_DE')
Comma-separated list of fields to retrieve (e.g., userId,payComponent,frequency,paycompvalue,currencyCode)
OData $orderby expression for sorting results (e.g., startDate desc)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLETool to retrieve continuous feedback records from SAP SuccessFactors Performance and Goals module using OData V4 protocol. Use when you need to query and retrieve feedback data with filtering, sorting, pagination, and field selection capabilities. Supports standard OData v4 query operations for flexible data retrieval.
Input parameters
Maximum number of feedback records to return (OData $top). Used for pagination.
Number of records to skip (OData $skip). Used with $top for pagination.
Include total count of records matching the query (OData $count). Ignores $top and $skip.
Navigation properties to expand inline (OData $expand). Example: requester,recipient
OData $filter expression to filter feedback records. Example: subjectUserId eq 'user123' or requesterId eq 'user456'
Comma-separated list of fields to retrieve (OData $select). Reduces data volume by selecting only relevant fields. Example: feedbackId,requestText,responseText
Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: requestDate desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_BUSINESS_UNITRetrieves foundation object business unit records for organizational structure hierarchy. Use when querying business unit information with support for filtering, sorting, and pagination.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
Navigation properties to expand (OData $expand)
OData $filter expression to filter business unit records
Comma-separated list of fields to retrieve (OData $select)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_COMPANYRetrieves foundation object company records from SAP SuccessFactors. Returns company information including display_name, legal_name, and entityOID for One Domain Model integration.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter companies. Example: "country eq 'US'"
Comma-separated list of fields to retrieve (OData $select parameter). Example: 'externalCode,displayName,legalName'
OData $orderby expression for sorting results. Example: 'externalCode asc'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_COST_CENTERRetrieves foundation object cost center records for organizational structure. Contains cost center information with entityOID for One Domain Model integration. Use standard OData query parameters to filter, sort, and paginate results.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $expand parameter to include related entities in the response
OData $filter expression to filter cost center records. Example: "startDate le datetime'2024-12-31'"
Comma-separated list of fields to retrieve (OData $select parameter). Example: "externalCode,name,description"
OData $orderby expression for sorting results. Example: "externalCode asc" or "lastModifiedDateTime desc"
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_DEPARTMENTTool to retrieve foundation object department records from SAP SuccessFactors. Use when you need to access organizational department structure information including team and group details.
Input parameters
Maximum number of records to return (OData $top parameter). Must be between 1 and 1000.
Number of records to skip for pagination (OData $skip parameter). Use with 'top' for pagination.
OData $filter expression to filter department records. Example: "status eq 'A'" or "startDate gt datetime'2023-01-01T00:00:00'"
Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_JOB_CODERetrieves foundation object job code records containing job classification information. Use when you need to fetch job codes with their associated metadata for positions.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter job code records. Example: startDate eq datetime'2024-01-01T00:00:00'
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results. Example: startDate desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_JOB_FUNCTIONTool to retrieve foundation object job function records for categorizing job roles. Use when you need to query job function data with support for filtering, field selection, and pagination via OData query options.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
OData $filter expression to filter job function records (e.g., "status eq 'ACTIVE'" or "externalCode eq 'JF001'")
Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned.
OData $orderby expression for sorting results (e.g., "name asc" or "externalCode desc")
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_LOCATIONTool to retrieve foundation object location records for work locations. Use when you need to query organizational location data including names, status, timezones, and address details.
Input parameters
Maximum number of location records to return (OData $top parameter)
Expand navigation properties like addressNavDEFLT to include related address details (OData $expand parameter)
OData filter expression to filter location records (e.g., "externalCode eq 'Seoul'" or "status eq 'A'")
Comma-separated list of fields to return (OData $select parameter, e.g., "externalCode,name,status,startDate")
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FO_PAY_GROUPRetrieves foundation object pay group records for compensation and payroll groupings. Use when querying pay group data from SAP SuccessFactors.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter pay groups. Example: 'status eq "ACTIVE"'
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results. Example: 'externalCode asc'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_FORM_CONTENTRetrieves performance form content from SAP SuccessFactors. Use to query forms with filters like form template ID or modification date.
Input parameters
Maximum number of records to return (OData $top). Maximum value is 1000.
Number of records to skip for pagination (OData $skip)
OData $filter expression to filter form content. Common filters include formTemplateId eq 'value' or lastModifiedDateTime gt datetime'2024-01-01T00:00:00'
Comma-separated list of fields to retrieve (OData $select)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_GOAL_PLAN_TEMPLATERetrieves goal plan template information from SAP SuccessFactors. Use when you need to fetch goal plan template configurations that define the structure of goals via DTD file.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter)
OData $filter expression to filter goal plan templates (e.g., 'id eq 11')
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results (e.g., 'name asc')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_GOALS_BY_PLANRetrieves performance goals data using the goal plan ID. Use this to query goals for a specific plan (e.g., Goal_11) with optional filtering by userId or other fields.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter goals (e.g., "userId eq 'user123'")
Comma-separated list of fields to retrieve via OData $select parameter
Goal plan ID to retrieve goals for (e.g., '11', '9')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_INTERVIEW_OVERALL_ASSESSMENTTool to retrieve overall interview ratings and navigation for assessments from Interview Central. Use when you need to fetch overall interview assessment data including ratings, recommendations, and comments.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter)
OData $filter expression to filter interview assessment records
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_JOB_APPLICATIONRetrieves job application records linking candidates to job requisitions. Use when you need to query application data, filter by status, or retrieve candidate application information.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter). Example: jobRequisition,candidate
OData $filter expression to filter job applications. Example: applicationId eq '12345' or status ne '4'
Comma-separated list of fields to retrieve (OData $select parameter). Example: applicationId,candidateId,jobReqId,firstName,lastName
OData $orderby expression for sorting results. Example: applicationId desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_JOB_REQ_SCREENING_QUESTIONTool to retrieve screening questions related to job requisitions from SAP SuccessFactors Recruiting. Use when you need to access screening questions for candidate assessment in the recruitment process.
Input parameters
Maximum number of screening question records to return (OData $top parameter). Limits the result set size.
Number of records to skip for pagination (OData $skip parameter). Use with $top for pagination.
OData $filter expression to filter screening questions. Example: "jobReqId eq 12345" or "locale eq 'en_US'"
Comma-separated list of fields to retrieve (OData $select parameter). Example: 'jobReqId,locale,order,questionId,questionName,questionType'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_JOB_REQUISITIONTool to retrieve job requisition records from SAP SuccessFactors Recruiting Management. Use when you need to read job requisitions, send them to third-party systems, or manage the recruiting workflow.
Input parameters
Maximum number of job requisition records to return (OData $top parameter). Limits the result set size.
Comma-separated list of navigation properties to expand (OData $expand parameter). Use to expand values from picklist fields such as the label and id. Example: 'status,location'
OData $filter expression to filter job requisitions. Example: "status eq 'Open'" or "city eq 'New York'"
Response format. Use 'json' for JSON format (OData $format parameter).
Comma-separated list of fields to retrieve (OData $select parameter). Example: 'jobReqId,jobCode,jobRole,city,department'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CALIB_SESSION_SERVICEGet OData metadata for Calibration Session service. Returns the service metadata including available entity sets. Use this to discover available entities in the CalSession.svc service.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CLOCK_INCLOCK_OUTGet OData metadata for Clock In/Clock Out Integration service. Returns the complete service schema including entity types, enum types, complex types, and entity container definitions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_NOMINATION_SERVICEGet OData metadata for Nomination service. Returns the service metadata including available entity sets for successor and talent pool nominations. Use this to discover available entities in the NominationService.svc service.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ODATA_METADATA_ONBOARDING_ADDLGet OData metadata for Onboarding Additional Services. Returns the complete service schema including available operations like updateUserNamePostHiring and getUserNameOfNewlyHiredEmployee.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ODATA_USER_METADATARetrieves the OData metadata document for the User entity describing its properties and operations. Use this to discover available fields, data types, and navigation properties for the User entity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_ONB2_PROCESSTool to retrieve Onboarding 2.0 process records for new hires from SAP SuccessFactors using OData V2 protocol. Use when you need to query onboarding workflow information with filtering, sorting, and field selection capabilities.
Input parameters
Maximum number of records to return (OData $top). Used for pagination.
Number of records to skip (OData $skip). Used with $top for pagination.
Navigation properties to expand inline (OData $expand). Example: user,manager
OData $filter expression to filter onboarding process records. Example: processStatus eq 'CANCELLED' or processType eq 'ONBOARDING'
Comma-separated list of fields to retrieve (OData $select). Example: processId,processStatus,user,manager
Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: createdDateTime desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_FEEDBACKTool to retrieve pending feedback requests or feedback request records from SAP SuccessFactors Continuous Feedback. Use when you need to query feedback requests with filtering, sorting, pagination, and field selection capabilities. Supports standard OData v4 query operations for flexible data retrieval.
Input parameters
Maximum number of feedback request records to return (OData $top). Used for pagination.
Number of records to skip (OData $skip). Used with $top for pagination.
Include total count of records matching the query (OData $count). Set to true to get count.
Navigation properties to expand inline (OData $expand). Example: feedback,activities
OData $filter expression to filter feedback requests. Example: status eq 'PENDING' or requesterAssignmentUUID eq 'uuid'
Comma-separated list of fields to retrieve (OData $select). Reduces data volume by selecting only relevant fields. Example: feedbackRequestId,status,topic
Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: createdDate desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_PER_PERSONALTool to retrieve personal information records from SAP SuccessFactors Employee Central. The PerPersonal entity contains non-effective-dated biographical information, emergency contacts, social media accounts, and email addresses. Use when you need to access personal information data.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
Navigation properties to expand (OData $expand), such as emergencyContactNav, emailNav, phoneNav
OData $filter expression to filter records (e.g., "personIdExternal eq '12345'" or "UserID ne null")
Comma-separated list of fields to retrieve via OData $select parameter. If not specified, all fields are returned.
OData $orderby expression for sorting results (e.g., "personIdExternal asc" or "lastModifiedOn desc")
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_PER_PERSON_BY_IDTool to retrieve person information for an employee by their external person ID. Use when you need to access core personal information data from SAP SuccessFactors Employee Central PerPerson entity.
Input parameters
Navigation properties to expand (OData $expand), such as personalInfoNav, employmentNav, emailNav, phoneNav
Comma-separated list of fields to retrieve via OData $select parameter
The external person ID for the employee
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_PICKLISTTool to retrieve picklist definitions from SAP SuccessFactors. Use when you need to fetch selectable value lists (picklists) that are used across various SuccessFactors entities.
Input parameters
Maximum number of picklists to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter, e.g., 'picklistOptions' to include picklist options)
OData $filter expression to filter picklists (e.g., "picklistId eq 'employee-type'")
Comma-separated list of fields to retrieve (OData $select parameter)
OData $orderby expression for sorting results (e.g., 'picklistId asc')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_PICKLIST_OPTIONRetrieves picklist option values with localized labels from SAP SuccessFactors. Use the localeLabel property to get text in the locale of the logged-in user. Supports OData query parameters for filtering, selection, and pagination.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
Navigation properties to expand (OData $expand parameter)
OData $filter expression to filter picklist options. Example: picklistId eq 'your_picklist_id'
Comma-separated list of fields to retrieve (OData $select parameter). Example: id,externalCode,localeLabel,picklistId
OData $orderby expression for sorting results. Example: sortOrder asc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_POSITIONRetrieves position management records from SAP SuccessFactors Employee Central. Use when you need to query position structure and hierarchy information.
Input parameters
Maximum number of records to return (OData $top parameter)
Navigation properties to expand in the response. Example: "jobCode,department"
OData $filter expression for filtering Position records. Example: "code eq 'P123'" or "effectiveStartDate ge datetime'2024-01-01T00:00:00'"
Response format (json or xml). Defaults to json
Set to 'snapshot' for snapshot-based pagination to handle large result sets
Comma-separated list of fields to return. Example: "code,positionTitle,effectiveStartDate"
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_TALENT_POOLRetrieves talent pool records including members and nomination details. Use when you need to access talent pool information for succession planning.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
Navigation properties to expand for related data (OData $expand)
OData $filter expression to filter talent pools (e.g., "Status eq 'A'" for active pools)
Comma-separated list of fields to retrieve (OData $select)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_TEMPORARY_TIME_INFORMATIONRetrieves temporary time information records from Time Management module. Use when you need to query temporary work schedules assigned to employees.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter temporary time information records. Example: userId eq 'user123' or startDate ge datetime'2024-01-01T00:00:00'
Comma-separated list of fields to retrieve (OData $select parameter). Example: externalCode,userId,startDate,endDate,workSchedule
OData $orderby expression for sorting results. Example: startDate desc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_TIME_ACCOUNT_SNAPSHOTRetrieves time account snapshot data for leave liability calculation and payroll. Use when you need balance information for employee time accounts as of a specific point in time.
Input parameters
Maximum number of records to return (OData $top parameter)
Number of records to skip for pagination (OData $skip parameter)
OData $filter expression to filter time account snapshots. Examples: userId eq 'jsmith', externalCode eq 'SNAPSHOT001', accountId eq 'VACATION'
Comma-separated list of fields to retrieve (OData $select parameter). Examples: userId,externalCode,accountId,balance
OData $orderby expression for sorting results. Examples: snapshotDate desc, userId asc
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GET_WORK_ORDERTool to retrieve work order records for contingent worker management from SAP SuccessFactors. Use when you need to query work order information with support for filtering, field selection, and pagination via OData query options.
Input parameters
Maximum number of records to return (OData $top). Default is 100.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
Navigation properties to expand in the response (OData $expand). Example: "userSysIdNav" to include user details.
OData $filter expression to filter WorkOrder records (e.g., "userSysId eq '1234'" or "startDate ge datetime'2024-01-01T00:00:00'")
Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_GIVE_OR_RESPOND_FEEDBACKTool to give performance feedback or respond to a feedback request in SAP SuccessFactors Continuous Performance Management. Use when you need to provide feedback on employee performance, strengths, development areas, or respond to existing feedback requests. Supports up to 3 question-answer pairs with extended field lengths (4000 characters per answer).
Input parameters
Topic of the feedback (e.g., 'Performance Feedback', 'Development Areas')
Answer to the first question (max 4000 characters)
Answer to the second question (optional, max 4000 characters)
Answer to the third question (optional, max 4000 characters)
First question for the feedback
Second question for the feedback (optional)
Third question for the feedback (optional)
Whether the feedback should be visible to the manager
Record ID of the feedback request being responded to (only needed when responding to an existing feedback request)
UUID of the user giving the feedback (must be the authenticated user)
UUID of the user receiving the feedback
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_LIST_CANDIDATESTool to retrieve a list of candidates from SAP SuccessFactors. Use when you need to query candidate data with OData filtering and pagination options.
Input parameters
Maximum number of candidates to return (OData $top parameter). Use for pagination.
Number of candidates to skip for pagination (OData $skip parameter).
OData $filter expression to filter candidates (e.g., "status eq 'Active'" or "lastName eq 'Smith'").
Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned.
OData $orderby expression for sorting results (e.g., "lastName asc" or "createdDate desc").
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_LIST_EMP_EMPLOYMENTTool to retrieve a list of all employment records from SAP SuccessFactors. Use when you need to query employment data including start dates, employment types, and assignment classes. Supports filtering by custom string fields (custom-string1, custom-string2, custom-string3) and userId.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
Navigation properties to expand via OData $expand parameter
OData $filter expression to filter employment records (e.g., userId eq '109031', custom-string1 eq 'value')
Comma-separated list of fields to retrieve (e.g., employmentId,userId,startDate,employmentType)
OData $orderby expression for sorting results (e.g., startDate desc)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_LIST_PER_PERSONTool to retrieve a list of person records from SAP SuccessFactors Employee Central. Use when you need to query employee personal information. The PerPerson entity is the foundation for all employee data in Employee Central and always returns the latest active record for each person.
Input parameters
Maximum number of person records to return (OData $top parameter). Use for pagination.
Number of records to skip for pagination (OData $skip parameter). Use with $top for paging through results.
OData $filter expression to filter person records. Example: "personIdExternal eq 'jsmith'" or "startDate gt datetime'2024-01-01T00:00:00'".
Comma-separated list of fields to retrieve (OData $select parameter). Example: "personIdExternal,firstName,lastName,dateOfBirth".
OData $orderby expression for sorting results. Example: "personIdExternal asc" or "startDate desc".
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_LIST_USERSTool to retrieve a list of all employee users from SAP SuccessFactors. Use when you need to query user information with support for filtering, field selection, and pagination via OData query options.
Input parameters
Maximum number of records to return (OData $top). Note: This API may have restrictions on using $top parameter.
Number of records to skip for pagination (OData $skip). Use with $top for pagination.
OData $filter expression to filter users (e.g., "username eq 'johndoe'" or "status eq 'active'")
Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_CLOCK_OUTQuery all available clock in/clock out groups. Use when you need to retrieve a list of all clock in/clock out groups configured in SAP SuccessFactors.
Input parameters
Maximum number of records to return (OData $top)
Number of records to skip for pagination (OData $skip)
OData $filter expression to filter clock in/out groups
Comma-separated list of fields to retrieve (OData $select)
OData $orderby expression for sorting results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_QUERY_CLOCK_CLOCK_OUT_GROUP_CODE_TIMEQuery a clock in/clock out group by code with time event types. Use when you need to retrieve details of a specific Clock In Clock Out Group including its configuration and optionally related Time Event Types.
Input parameters
The unique identifier code for the Clock In Clock Out Group to retrieve (e.g., 'TETG-1', 'Group1')
OData $expand parameter to include related entities. Use 'timeEventTypeNav' to expand related Time Event Types
Comma-separated list of fields to retrieve (OData $select)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_REFRESH_CDP_LEARNING_METADATARefresh metadata for Career Development Planning Learning service.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_REFRESH_METADATA_CONT_FEEDBACK_SERVICERefresh metadata cache for Continuous Feedback service. Use when metadata changes need to be applied without service interruption.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_UPDATE_CALIBRATION_SUBJECT_RATINGSUpdate a subject's competency ratings in a calibration session.
Input parameters
Mark subject as calibrated
The calibration session ID
The subject ID to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SAP_SUCCESSFACTORS_UPDATE_INTERNAL_USERNAME_NEW_HIRES_AFTERUpdate the internal username of new hires after hiring process is completed from Active Directory. Use after Manage Pending Hire (MPH) submit and before day 1 (pre-conversion). Requires 'Manage Onboarding 2.0 or Offboarding 2.0 Update New Hire Data for External HRIS' permission.
Input parameters
The unique identifier of the user/new hire whose username needs to be updated
The new username to be assigned to the user, typically generated from Active Directory. This will be the internal username field that gets updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 82 agents privately built on Nagent that already use SAP SuccessFactors.
Build on Nagent
Connect SAP SuccessFactors to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find SAP SuccessFactors, and click "Connect Now." You'll authenticate with SAML — Nagent handles credential storage and refresh automatically. Once connected, SAP SuccessFactors is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once SAP SuccessFactors is connected, you configure its 64 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop SAP SuccessFactors steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a SAP SuccessFactors event fires, the agent kicks off automatically.
Every SAP SuccessFactors action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While SAP SuccessFactors ships with 64 pre-built human resources actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching SAP SuccessFactors together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build SAP SuccessFactors-based workflows tailored to your business.