# SAP SuccessFactors

Cloud-based human capital management software covering Employee Central, Recruiting, Performance & Goals, Learning, Compensation, and more.

- **Category:** human resources
- **Auth:** SAML
- **Composio Managed App Available?** N/A
- **Tools:** 64
- **Triggers:** 0
- **Slug:** `SAP_SUCCESSFACTORS`
- **Version:** 20260223_00

## Tools

### Approve Calibration Session

**Slug:** `SAP_SUCCESSFACTORS_APPROVE_CALIBRATION_SESSION`

Finalize a calibration session that is in the In Progress or Approving status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comments` | string | No | Optional comments for the approval |
| `session_id` | string | Yes | The calibration session ID to approve/finalize |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create a Feedback Request

**Slug:** `SAP_SUCCESSFACTORS_CREATE_A_FEEDBACK_REQUEST`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `topic` | string | Yes | Topic or title of the feedback request. Describes what the feedback is about. |
| `question1` | string | No | First feedback question. At least one question must be provided. Questions must be in order (cannot skip question1 if providing question2 or question3). |
| `question2` | string | No | Second feedback question. Can only be provided if question1 is also provided. Questions must be in order. |
| `question3` | string | No | Third feedback question. Can only be provided if both question1 and question2 are provided. Questions must be in order. |
| `requestText` | string | No | Optional additional text or context for the feedback request. Note: This field is not supported by the SAP SuccessFactors API and will be ignored. |
| `recipientAssignmentUUID` | string | Yes | Assignment UUID of the recipient (the person who will provide the feedback). This is who will be asked to provide feedback. |
| `requesterAssignmentUUID` | string | Yes | Assignment UUID of the requester (must be the authenticated user). This is the person requesting the feedback. |
| `subjectUserAssignmentUUID` | string | Yes | Assignment UUID of the subject user (the person the feedback is about). This is who the feedback will be about. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Learning Activities Bulk

**Slug:** `SAP_SUCCESSFACTORS_CREATE_LEARNING_ACTIVITIES_BULK`

Create learning activities and associate them with development goals in bulk (requires third-party LMS integration).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `activities` | array | Yes | List of learning activities to create (requires third-party LMS integration) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Onboardee

**Slug:** `SAP_SUCCESSFACTORS_CREATE_ONBOARDEE`

Creates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the onboardee. Must be a valid email format. |
| `userId` | string | Yes | The user ID for the onboardee. This is a unique identifier for the user in the system. |
| `password` | string | Yes | Password for the onboardee account. Must meet the system's password requirements. |
| `userName` | string | Yes | The username for the onboardee. This will be used as the login identifier. |
| `isNewHire` | string | No | Indicates if this is a new hire. Expected values: 'Yes' or 'No'. If not provided, system defaults will apply. |
| `applicationId` | string | Yes | The application ID for the onboarding process. This identifies which onboarding workflow to use. |
| `isRehireOnOldEmployment` | boolean | No | Identifies if the person is a rehire. Set to true to find and link to old employment record in the system. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create or Update Successor Nomination

**Slug:** `SAP_SUCCESSFACTORS_CREATE_UPDATE_SUCCESSOR_NOMINATION`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Optional notes or comments about the nomination. |
| `rank` | integer | No | The ranking of the successor nominee. Used when multiple successors are nominated for the same position or pool. |
| `user_id` | string | Yes | The user ID of the nominee to be added or updated in the nomination. |
| `readiness` | number | No | The readiness level of the successor nominee. Typically a numeric value indicating how ready the person is for the role. |
| `emergency_cover` | boolean | No | Indicates if the nominee is designated as emergency cover for the position. |
| `nomination_target` | string | Yes | Position code or talent pool identifier for the nomination target. |
| `is_pool_nomination` | boolean | Yes | Indicates if this is a talent pool nomination. Set to false for position-based nominations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Nomination

**Slug:** `SAP_SUCCESSFACTORS_DELETE_NOMINATION_POSITION_TALENT_POOL`

Delete 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The user ID of the nominee to be removed from the nomination. |
| `nomination_target` | string | Yes | Position code or talent pool identifier for the nomination target. |
| `is_pool_nomination` | boolean | Yes | Indicates if this is a talent pool nomination. Set to false for position-based nominations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Application Interview

**Slug:** `SAP_SUCCESSFACTORS_GET_APPLICATION_INTERVIEW`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter) |
| `filter` | string | No | 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. |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Background Education

**Slug:** `SAP_SUCCESSFACTORS_GET_BACKGROUND_EDUCATION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand (OData $expand) |
| `filter` | string | No | OData $filter expression to filter education records (e.g., "userId eq 'jdoe'" or "school eq 'MIT'") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Background Mobility

**Slug:** `SAP_SUCCESSFACTORS_GET_BACKGROUND_MOBILITY`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter) |
| `filter` | string | No | OData $filter expression to filter mobility records (e.g., "userId eq '12345'" or "bgOrderPos eq 1") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned. |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: bgOrderPos asc or startDate desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calibration Session By ID

**Slug:** `SAP_SUCCESSFACTORS_GET_CALIBRATION_SESSION_BY_ID`

Get a specific calibration session by session ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Navigation properties to expand (OData $expand) |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `session_id` | string | Yes | The calibration session ID to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calibration Sessions

**Slug:** `SAP_SUCCESSFACTORS_GET_CALIBRATION_SESSIONS`

Query all the calibration sessions that a user can access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `filter` | string | No | OData $filter expression to filter sessions |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calibration Subject By ID

**Slug:** `SAP_SUCCESSFACTORS_GET_CALIBRATION_SUBJECT_BY_ID`

Query a specific subject's competency ratings and ratings within a calibration session.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Navigation properties to expand (OData $expand) |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `session_id` | string | Yes | The calibration session ID |
| `subject_id` | string | Yes | The subject ID to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calibration Subject Ratings

**Slug:** `SAP_SUCCESSFACTORS_GET_CALIBRATION_SUBJECT_RATINGS`

Query a subject's ratings, competency ratings, and comments by using session ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `filter` | string | No | OData $filter expression to filter subjects |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `session_id` | string | Yes | The calibration session ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get CDP Learning Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_CDP_LEARNING_METADATA`

Get metadata for Career Development Planning Learning service.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `SAP_SUCCESSFACTORS_GET_CURRENT_USER`

Retrieves the currently authenticated user's information from SAP SuccessFactors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select_fields` | string | No | Comma-separated list of fields to retrieve via OData $select parameter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Custom MDF Object

**Slug:** `SAP_SUCCESSFACTORS_GET_CUSTOM_MDF_OBJECT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand (OData $expand), such as createdByNav, lastModifiedByNav, externalCodeNav |
| `filter` | string | No | OData $filter expression to filter custom MDF object records |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter |
| `objectName` | string | Yes | The name of the custom MDF object (without cust_ prefix). Example: COVID_19_VACCINE_TRACKING, EmpLetterRequest, HEALTH_STATUS_TRACKING |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Employee Employment Termination

**Slug:** `SAP_SUCCESSFACTORS_GET_EMP_EMPLOYMENT_TERMINATION`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand via OData $expand parameter (e.g., "jobInfoNav" to include job information) |
| `filter` | string | No | OData $filter expression to filter termination records (e.g., "userId eq '12345'" or "endDate ge datetime'2024-01-01T00:00:00'") |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter. If not specified, all fields are returned. |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., "endDate desc" or "userId asc") |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Employee Time

**Slug:** `SAP_SUCCESSFACTORS_GET_EMPLOYEE_TIME`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `filter` | string | No | 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' |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Employee Timesheet

**Slug:** `SAP_SUCCESSFACTORS_GET_EMPLOYEE_TIMESHEET`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Expand related entities to include in the response (OData $expand parameter). Common navigations: userIdNav, employeeTimeSheetEntry, allowance |
| `filter` | string | No | 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'") |
| `format` | string | No | Response format (json or xml). Defaults to json |
| `select` | string | No | Comma-separated list of fields to include in the response (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results. Specify field name and optionally 'asc' or 'desc' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Non-Recurring Pay Components

**Slug:** `SAP_SUCCESSFACTORS_GET_EMP_PAY_COMP_NON_RECURRING`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `expand` | string | No | Navigation properties to expand via OData $expand parameter |
| `filter` | string | No | OData $filter expression to filter non-recurring pay component records (e.g., userId eq 'cgrant', payDate eq datetime'2024-01-15T00:00:00') |
| `select` | string | No | Comma-separated list of fields to retrieve (e.g., userId,seqNumber,payComponentCode,amount,currency,payDate) |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., payDate desc) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Recurring Pay Components

**Slug:** `SAP_SUCCESSFACTORS_GET_EMP_PAY_COMP_RECURRING`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `expand` | string | No | Navigation properties to expand via OData $expand parameter |
| `filter` | string | No | 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') |
| `select` | string | No | Comma-separated list of fields to retrieve (e.g., userId,payComponent,frequency,paycompvalue,currencyCode) |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., startDate desc) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Feedback Records

**Slug:** `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of feedback records to return (OData $top). Used for pagination. |
| `skip` | integer | No | Number of records to skip (OData $skip). Used with $top for pagination. |
| `count` | boolean | No | Include total count of records matching the query (OData $count). Ignores $top and $skip. |
| `expand` | string | No | Navigation properties to expand inline (OData $expand). Example: requester,recipient |
| `filter` | string | No | OData $filter expression to filter feedback records. Example: subjectUserId eq 'user123' or requesterId eq 'user456' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). Reduces data volume by selecting only relevant fields. Example: feedbackId,requestText,responseText |
| `orderby` | string | No | Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: requestDate desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FOBusinessUnit

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_BUSINESS_UNIT`

Retrieves foundation object business unit records for organizational structure hierarchy. Use when querying business unit information with support for filtering, sorting, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `expand` | string | No | Navigation properties to expand (OData $expand) |
| `filter` | string | No | OData $filter expression to filter business unit records |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FOCompany Records

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_COMPANY`

Retrieves foundation object company records from SAP SuccessFactors. Returns company information including display_name, legal_name, and entityOID for One Domain Model integration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter companies. Example: "country eq 'US'" |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: 'externalCode,displayName,legalName' |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: 'externalCode asc' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Foundation Object Cost Centers

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_COST_CENTER`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | OData $expand parameter to include related entities in the response |
| `filter` | string | No | OData $filter expression to filter cost center records. Example: "startDate le datetime'2024-12-31'" |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: "externalCode,name,description" |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: "externalCode asc" or "lastModifiedDateTime desc" |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FODepartment Records

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_DEPARTMENT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter). Must be between 1 and 1000. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter). Use with 'top' for pagination. |
| `filter` | string | No | OData $filter expression to filter department records. Example: "status eq 'A'" or "startDate gt datetime'2023-01-01T00:00:00'" |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Foundation Object Job Codes

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_JOB_CODE`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter job code records. Example: startDate eq datetime'2024-01-01T00:00:00' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: startDate desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Functions

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_JOB_FUNCTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `filter` | string | No | OData $filter expression to filter job function records (e.g., "status eq 'ACTIVE'" or "externalCode eq 'JF001'") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned. |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., "name asc" or "externalCode desc") |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Foundation Object Location

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_LOCATION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of location records to return (OData $top parameter) |
| `expand` | string | No | Expand navigation properties like addressNavDEFLT to include related address details (OData $expand parameter) |
| `filter` | string | No | OData filter expression to filter location records (e.g., "externalCode eq 'Seoul'" or "status eq 'A'") |
| `select` | string | No | Comma-separated list of fields to return (OData $select parameter, e.g., "externalCode,name,status,startDate") |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FOPayGroup

**Slug:** `SAP_SUCCESSFACTORS_GET_FO_PAY_GROUP`

Retrieves foundation object pay group records for compensation and payroll groupings. Use when querying pay group data from SAP SuccessFactors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter pay groups. Example: 'status eq "ACTIVE"' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: 'externalCode asc' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Form Content

**Slug:** `SAP_SUCCESSFACTORS_GET_FORM_CONTENT`

Retrieves performance form content from SAP SuccessFactors. Use to query forms with filters like form template ID or modification date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Maximum value is 1000. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `filter` | string | No | OData $filter expression to filter form content. Common filters include formTemplateId eq 'value' or lastModifiedDateTime gt datetime'2024-01-01T00:00:00' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Goal Plan Template

**Slug:** `SAP_SUCCESSFACTORS_GET_GOAL_PLAN_TEMPLATE`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter) |
| `filter` | string | No | OData $filter expression to filter goal plan templates (e.g., 'id eq 11') |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., 'name asc') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Goals By Plan

**Slug:** `SAP_SUCCESSFACTORS_GET_GOALS_BY_PLAN`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter goals (e.g., "userId eq 'user123'") |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter |
| `plan_id` | string | Yes | Goal plan ID to retrieve goals for (e.g., '11', '9') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Interview Overall Assessment

**Slug:** `SAP_SUCCESSFACTORS_GET_INTERVIEW_OVERALL_ASSESSMENT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter) |
| `filter` | string | No | OData $filter expression to filter interview assessment records |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Application

**Slug:** `SAP_SUCCESSFACTORS_GET_JOB_APPLICATION`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter). Example: jobRequisition,candidate |
| `filter` | string | No | OData $filter expression to filter job applications. Example: applicationId eq '12345' or status ne '4' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: applicationId,candidateId,jobReqId,firstName,lastName |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: applicationId desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Requisition Screening Questions

**Slug:** `SAP_SUCCESSFACTORS_GET_JOB_REQ_SCREENING_QUESTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of screening question records to return (OData $top parameter). Limits the result set size. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter). Use with $top for pagination. |
| `filter` | string | No | OData $filter expression to filter screening questions. Example: "jobReqId eq 12345" or "locale eq 'en_US'" |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: 'jobReqId,locale,order,questionId,questionName,questionType' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Requisition

**Slug:** `SAP_SUCCESSFACTORS_GET_JOB_REQUISITION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of job requisition records to return (OData $top parameter). Limits the result set size. |
| `expand` | string | No | 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' |
| `filter` | string | No | OData $filter expression to filter job requisitions. Example: "status eq 'Open'" or "city eq 'New York'" |
| `format` | string | No | Response format. Use 'json' for JSON format (OData $format parameter). |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: 'jobReqId,jobCode,jobRole,city,department' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Calibration Session Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CALIB_SESSION_SERVICE`

Get 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Clock In/Out Integration Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CLOCK_INCLOCK_OUT`

Get 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Nomination Service Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_NOMINATION_SERVICE`

Get 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onboarding Additional Services Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_ONBOARDING_ADDL`

Get OData metadata for Onboarding Additional Services. Returns the complete service schema including available operations like updateUserNamePostHiring and getUserNameOfNewlyHiredEmployee.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Entity Metadata

**Slug:** `SAP_SUCCESSFACTORS_GET_ODATA_USER_METADATA`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onboarding 2.0 Processes

**Slug:** `SAP_SUCCESSFACTORS_GET_ONB2_PROCESS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Used for pagination. |
| `skip` | integer | No | Number of records to skip (OData $skip). Used with $top for pagination. |
| `expand` | string | No | Navigation properties to expand inline (OData $expand). Example: user,manager |
| `filter` | string | No | OData $filter expression to filter onboarding process records. Example: processStatus eq 'CANCELLED' or processType eq 'ONBOARDING' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). Example: processId,processStatus,user,manager |
| `orderby` | string | No | Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: createdDateTime desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Pending Feedback Requests

**Slug:** `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_FEEDBACK`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of feedback request records to return (OData $top). Used for pagination. |
| `skip` | integer | No | Number of records to skip (OData $skip). Used with $top for pagination. |
| `count` | boolean | No | Include total count of records matching the query (OData $count). Set to true to get count. |
| `expand` | string | No | Navigation properties to expand inline (OData $expand). Example: feedback,activities |
| `filter` | string | No | OData $filter expression to filter feedback requests. Example: status eq 'PENDING' or requesterAssignmentUUID eq 'uuid' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). Reduces data volume by selecting only relevant fields. Example: feedbackRequestId,status,topic |
| `orderby` | string | No | Sort expression (OData $orderby). Sort by properties in ascending (asc) or descending (desc) order. Example: createdDate desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Personal Information Records

**Slug:** `SAP_SUCCESSFACTORS_GET_PER_PERSONAL`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand (OData $expand), such as emergencyContactNav, emailNav, phoneNav |
| `filter` | string | No | OData $filter expression to filter records (e.g., "personIdExternal eq '12345'" or "UserID ne null") |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter. If not specified, all fields are returned. |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., "personIdExternal asc" or "lastModifiedOn desc") |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Person by ID

**Slug:** `SAP_SUCCESSFACTORS_GET_PER_PERSON_BY_ID`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Navigation properties to expand (OData $expand), such as personalInfoNav, employmentNav, emailNav, phoneNav |
| `select` | string | No | Comma-separated list of fields to retrieve via OData $select parameter |
| `personIdExternal` | string | Yes | The external person ID for the employee |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Picklist

**Slug:** `SAP_SUCCESSFACTORS_GET_PICKLIST`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of picklists to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter, e.g., 'picklistOptions' to include picklist options) |
| `filter` | string | No | OData $filter expression to filter picklists (e.g., "picklistId eq 'employee-type'") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter) |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., 'picklistId asc') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Picklist Option

**Slug:** `SAP_SUCCESSFACTORS_GET_PICKLIST_OPTION`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `expand` | string | No | Navigation properties to expand (OData $expand parameter) |
| `filter` | string | No | OData $filter expression to filter picklist options. Example: picklistId eq 'your_picklist_id' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: id,externalCode,localeLabel,picklistId |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: sortOrder asc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Position

**Slug:** `SAP_SUCCESSFACTORS_GET_POSITION`

Retrieves position management records from SAP SuccessFactors Employee Central. Use when you need to query position structure and hierarchy information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `expand` | string | No | Navigation properties to expand in the response. Example: "jobCode,department" |
| `filter` | string | No | OData $filter expression for filtering Position records. Example: "code eq 'P123'" or "effectiveStartDate ge datetime'2024-01-01T00:00:00'" |
| `format` | string | No | Response format (json or xml). Defaults to json |
| `paging` | string | No | Set to 'snapshot' for snapshot-based pagination to handle large result sets |
| `select` | string | No | Comma-separated list of fields to return. Example: "code,positionTitle,effectiveStartDate" |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Talent Pool

**Slug:** `SAP_SUCCESSFACTORS_GET_TALENT_POOL`

Retrieves talent pool records including members and nomination details. Use when you need to access talent pool information for succession planning.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `expand` | string | No | Navigation properties to expand for related data (OData $expand) |
| `filter` | string | No | OData $filter expression to filter talent pools (e.g., "Status eq 'A'" for active pools) |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Temporary Time Information

**Slug:** `SAP_SUCCESSFACTORS_GET_TEMPORARY_TIME_INFORMATION`

Retrieves temporary time information records from Time Management module. Use when you need to query temporary work schedules assigned to employees.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter temporary time information records. Example: userId eq 'user123' or startDate ge datetime'2024-01-01T00:00:00' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: externalCode,userId,startDate,endDate,workSchedule |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: startDate desc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Time Account Snapshot

**Slug:** `SAP_SUCCESSFACTORS_GET_TIME_ACCOUNT_SNAPSHOT`

Retrieves 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top parameter) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter) |
| `filter` | string | No | OData $filter expression to filter time account snapshots. Examples: userId eq 'jsmith', externalCode eq 'SNAPSHOT001', accountId eq 'VACATION' |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Examples: userId,externalCode,accountId,balance |
| `orderby` | string | No | OData $orderby expression for sorting results. Examples: snapshotDate desc, userId asc |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Work Order

**Slug:** `SAP_SUCCESSFACTORS_GET_WORK_ORDER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Default is 100. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `expand` | string | No | Navigation properties to expand in the response (OData $expand). Example: "userSysIdNav" to include user details. |
| `filter` | string | No | OData $filter expression to filter WorkOrder records (e.g., "userSysId eq '1234'" or "startDate ge datetime'2024-01-01T00:00:00'") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Give Feedback or Respond to Feedback Request

**Slug:** `SAP_SUCCESSFACTORS_GIVE_FEEDBACK_OR_RESPOND_TO_A_FEEDBACK_REQUEST`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `topic` | string | Yes | Topic of the feedback (e.g., 'Performance Feedback', 'Development Areas') |
| `answer1` | string | Yes | Answer to the first question (max 4000 characters) |
| `answer2` | string | No | Answer to the second question (optional, max 4000 characters) |
| `answer3` | string | No | Answer to the third question (optional, max 4000 characters) |
| `question1` | string | Yes | First question for the feedback |
| `question2` | string | No | Second question for the feedback (optional) |
| `question3` | string | No | Third question for the feedback (optional) |
| `visibleToManager` | boolean | No | Whether the feedback should be visible to the manager |
| `feedbackRequestRecordId` | string | No | Record ID of the feedback request being responded to (only needed when responding to an existing feedback request) |
| `senderUserAssignmentUUID` | string | Yes | UUID of the user giving the feedback (must be the authenticated user) |
| `subjectUserAssignmentUUID` | string | Yes | UUID of the user receiving the feedback |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Candidates

**Slug:** `SAP_SUCCESSFACTORS_LIST_CANDIDATES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of candidates to return (OData $top parameter). Use for pagination. |
| `skip` | integer | No | Number of candidates to skip for pagination (OData $skip parameter). |
| `filter` | string | No | OData $filter expression to filter candidates (e.g., "status eq 'Active'" or "lastName eq 'Smith'"). |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). If not specified, all fields are returned. |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., "lastName asc" or "createdDate desc"). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Employee Employment Records

**Slug:** `SAP_SUCCESSFACTORS_LIST_EMP_EMPLOYMENT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `expand` | string | No | Navigation properties to expand via OData $expand parameter |
| `filter` | string | No | OData $filter expression to filter employment records (e.g., userId eq '109031', custom-string1 eq 'value') |
| `select` | string | No | Comma-separated list of fields to retrieve (e.g., employmentId,userId,startDate,employmentType) |
| `orderby` | string | No | OData $orderby expression for sorting results (e.g., startDate desc) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Person Records

**Slug:** `SAP_SUCCESSFACTORS_LIST_PER_PERSON`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of person records to return (OData $top parameter). Use for pagination. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip parameter). Use with $top for paging through results. |
| `filter` | string | No | OData $filter expression to filter person records. Example: "personIdExternal eq 'jsmith'" or "startDate gt datetime'2024-01-01T00:00:00'". |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select parameter). Example: "personIdExternal,firstName,lastName,dateOfBirth". |
| `orderby` | string | No | OData $orderby expression for sorting results. Example: "personIdExternal asc" or "startDate desc". |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `SAP_SUCCESSFACTORS_LIST_USERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top). Note: This API may have restrictions on using $top parameter. |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip). Use with $top for pagination. |
| `filter` | string | No | OData $filter expression to filter users (e.g., "username eq 'johndoe'" or "status eq 'active'") |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select). If not specified, all fields are returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query All Available Clock In/Clock Out Groups

**Slug:** `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_CLOCK_OUT`

Query 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | Maximum number of records to return (OData $top) |
| `skip` | integer | No | Number of records to skip for pagination (OData $skip) |
| `filter` | string | No | OData $filter expression to filter clock in/out groups |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |
| `orderby` | string | No | OData $orderby expression for sorting results |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Clock In/Clock Out Group By Code

**Slug:** `SAP_SUCCESSFACTORS_QUERY_CLOCK_CLOCK_OUT_GROUP_CODE_TIME`

Query 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | The unique identifier code for the Clock In Clock Out Group to retrieve (e.g., 'TETG-1', 'Group1') |
| `expand` | string | No | OData $expand parameter to include related entities. Use 'timeEventTypeNav' to expand related Time Event Types |
| `select` | string | No | Comma-separated list of fields to retrieve (OData $select) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Refresh CDP Learning Metadata

**Slug:** `SAP_SUCCESSFACTORS_REFRESH_CDP_LEARNING_METADATA`

Refresh metadata for Career Development Planning Learning service.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Refresh Metadata for Continuous Feedback

**Slug:** `SAP_SUCCESSFACTORS_REFRESH_METADATA_CONT_FEEDBACK_SERVICE`

Refresh metadata cache for Continuous Feedback service. Use when metadata changes need to be applied without service interruption.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Calibration Subject Ratings

**Slug:** `SAP_SUCCESSFACTORS_UPDATE_CALIBRATION_SUBJECT_RATINGS`

Update a subject's competency ratings in a calibration session.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `calibrated` | boolean | No | Mark subject as calibrated |
| `session_id` | string | Yes | The calibration session ID |
| `subject_id` | string | Yes | The subject ID to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Username Post Hiring

**Slug:** `SAP_SUCCESSFACTORS_UPDATE_INTERNAL_USERNAME_NEW_HIRES_AFTER`

Update 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the user/new hire whose username needs to be updated |
| `user_name` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |