execute_upsert
Upsert records to a SuccessFactors entity in batches. Use dry_run mode to validate before writing data.
Instructions
Execute an upsert operation against an SF entity.
IMPORTANT: Defaults to dry_run=True. In dry_run mode, validates all records against metadata without making any changes. Set dry_run=False to actually write data.
Records are processed in batches. Each record is sent as an individual OData POST (upsert) to the entity endpoint.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity_name": "<entity_name>",
"records": "<records>"
},
"name": "execute_upsert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If True (default), validates without writing. Set to False to actually execute. | |
| records | Yes | List of record dictionaries to upsert | |
| batch_size | No | Records per batch (1-50) | |
| data_center | No | ||
| entity_name | Yes | Target SF entity | |
| auth_user_id | No | ||
| auth_password | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||