# SAP SuccessFactors

> Connect SAP SuccessFactors to automate employee and organization records.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/sap-successfactors

## Actions

### Get person

Get one person record by its person ID, with the person's identity details such as date and place of birth.

**Inputs**

- Record id (`record_id`, text, required): Record id for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get position

Get one position by its code and effective start date, with its title, department, job code and other details as of that date.

**Inputs**

- Record id (`record_id`, text, required): Record id for this request.
- Effective start date (`effective_start_date`, date, required): The date this position version starts, from List positions.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get user

Get one SuccessFactors user by their user ID, with their name, email, department, manager and status.

**Inputs**

- Record id (`record_id`, text, required): Record id for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List business units

List the business units in your organization structure, optionally filtered and within an effective date range, with each one's code, name and status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List companies

List the legal entities (companies) set up in SuccessFactors, optionally filtered and within an effective date range, with each one's code, name and country.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List cost centers

List cost centers, optionally filtered and within an effective date range, with each one's code, name and status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List departments

List the departments in your organization structure, optionally filtered and within an effective date range, with each one's code, name and status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List divisions

List the divisions in your organization structure, optionally filtered and within an effective date range, with each one's code, name and status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List email addresses

List the email addresses on person records, optionally filtered, with each address, its type and whether it is primary.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List employment records

List employment records, optionally filtered and sorted, with each employee's start date, end date and employment details.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List event reasons

List the event reasons used for job changes, such as hire or promotion, optionally filtered and within an effective date range, with each one's code and name.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List job codes

List the job codes (job classifications) set up in SuccessFactors, optionally filtered and within an effective date range, with each one's code and name.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List job records

List job information records, optionally filtered and within an effective date range, with each employee's position, department, manager and job code.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List locations

List the work locations set up in SuccessFactors, optionally filtered and within an effective date range, with each one's code, name and address.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List people

List person records (PerPerson), the core identity of each employee, optionally filtered and sorted, with each person's ID and date of birth.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List personal information

List personal information records, optionally filtered and within an effective date range, with each person's names, gender and marital status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List phone numbers

List the phone numbers on person records, optionally filtered, with each number, its type and whether it is primary.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List positions

List positions, optionally filtered and within an effective date range, with each position's code, title, department and effective dates.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.
- From date (`from_date`, date): From date for this request.
- To date (`to_date`, date): To date for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### List users

List SuccessFactors user accounts, optionally filtered, sorted and limited to chosen properties. Returns each user's ID, name, email and status.

**Inputs**

- Filter (`filter`, text): Filter for this request.
- Select (`select`, text): Select for this request.
- Order by (`order_by`, text): Order by for this request.
- Page size (`page_size`, number): Page size for this request. From 1 to 1000.
- Offset (`offset`, number): Offset for this request. At least 0.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Upsert records

Create or update one or more SuccessFactors records in a single request, matched on their keys. Returns the outcome for each record.

**Inputs**

- Records (`records`, list, required): Records for this request.

**Outputs**

- `data` (object): The service response, including all records and metadata.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation value for the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```
