SAP SuccessFactors API
SAP SuccessFactors is cloud-based human resources software (HCM/HXM) that centralizes core HR (Employee Central), recruiting, onboarding, performance, compensation, learning, time tracking, and payroll. An unofficial API lets you programmatically pull employee profiles, job informatio
What is SAP SuccessFactors?
SAP SuccessFactors is a cloud HCM/HXM suite used by enterprises to manage the full employee lifecycle: hire, onboard, develop, reward, and retain. It provides Employee Central (core HR), Recruiting and Onboarding, Performance & Goals, Compensation, Succession & Development, Learning, Time Management, and payroll integrations—all governed by robust role-based permissions (RBP) and effective-dated records.
Core product areas include:
- Employee Central (Persons, Employments, Job Information, Positions, Org Units, Cost Centers)
- Recruiting & Onboarding (Job Requisitions, Candidates, Applications, Offers, Preboarding Tasks)
- Time Management (Time Off Policies, Absence Requests, Balances, Timesheets)
- Learning (Items/Courses, Assignments, Completions, Certifications)
- Performance & Compensation (Goals, Reviews, Pay Components, Bonus/Stock)
- People Analytics & Reporting (Dashboards, Story Reports, Workforce Analytics)
Common data entities:
- Companies, Users, Roles/Permissions (Employee, Manager, HR, Recruiter)
- Employees/Persons (personal data, contacts, national IDs)
- Employments & Job Information (effective-dated job, location, department, cost center, manager)
- Positions & Org Units (hierarchy, headcount, vacancy status)
- Time Off (policies, accruals, balances, absence requests)
- Timesheets (work segments, cost allocations)
- Recruiting (job requisitions, candidates, applications, offers)
- Onboarding (tasks, documents, compliance checklists)
- Learning (items, curricula, assignments, completions, certificates)
The SAP SuccessFactors Integration Challenge
Enterprises rely on SuccessFactors daily, but turning portal- and OData-based workflows into API-driven automation is complex:
- Effective dating: Core HR data is split across person/employment segments and time slices; updates require correct effectiveDate handling
- Role-based permissions: RBP gates fields and modules; visibility and edit rights vary by tenant, user role, and object configuration
- API fragmentation: OData v2 covers most modules, SFAPI SOAP is still used for CompoundEmployee, Recruiting/Learning have unique schemas and attachment flows
- Authentication complexity: SSO via SAP IAS (SAML/OAuth), MFA, CSRF tokens, and session lifecycles complicate headless automation
- Tenant variability: MDF objects, custom fields, picklists, and workflows differ across tenants, breaking generic integrations
- Data export pain: Integration Center jobs are batch-oriented, throttled, and not event-driven; delta syncs and pagination need careful tuning
- ID chaos: userId vs personId/externalId vs employeeId; requisition and candidate IDs differ by module; mapping is required
How Supergood Creates SAP SuccessFactors APIs
Supergood reverse-engineers authenticated browser flows and official API interactions to deliver a resilient endpoint layer for your SuccessFactors tenant.
- Handles username/password, SSO/OAuth (SAP IAS), and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh, CSRF token management, and change detection
- Normalizes effective-dated responses so you can integrate once and rely on consistent objects across modules
- Maps IDs across Candidate/Employee/Person objects and reconciles custom fields and picklists
- Aligns with tenant configuration, entitlements, and RBP to ensure compliant access
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened SuccessFactors adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as SuccessFactors evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth (SAP IAS) when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Employees
/employeesList employees with effective-dated job information and summary details.
Employees
/employees/{employeeId}Update effective-dated job attributes (e.g., business title, manager, location).
Time Off Requests
/time-off/requestsCreate an absence request for an employee with validation against policy and balances.
Recruiting Candidates
/recruiting/candidatesCreate a candidate with optional resume upload and apply to a requisition.
Use Cases
HR Data Sync & Identity Provisioning
- Mirror employees, positions, managers, and org units into your internal systems - Keep job info, locations, and cost centers current for RBAC, approvals, and directory - Normalize effective dating and detect changes via lastModified timestamps
Recruiting & Onboarding Automation
- Create candidates from your career site or CRM, attach resumes, and apply to requisitions - Track application status and offers, trigger onboarding tasks, and provision accounts in your product - Consolidate recruiter workflows across regions and brands
Time & Absence Management
- Submit and approve time-off requests from your app, with balance checks and policy validation - Export absence and timesheet data to planning, scheduling, or payroll systems (e.g., ADP) - Drive SLA alerts and manager notifications for pending requests
Learning & Compliance
- Sync training assignments and completions for certifications and compliance reporting - Trigger reminders for overdue courses and surface completion status in your product - Aggregate multi-tenant learning data for analytics in Snowflake or your BI stack
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth via SAP IAS where enabled; supports service accounts or customer-managed credentials
Response format
JSON with normalized effective-dated schemas and consistent pagination across modules
Rate limits
Tuned for enterprise throughput while honoring tenant throttles and usage controls
Session management
Automatic reauth, CSRF token rotation, and cookie/session health checks
Data freshness
Near real-time retrieval of employees, recruiting, time off, and learning objects
Security
Encrypted transport, scoped tokens, and audit logging; respects SuccessFactors role-based permissions
Webhooks
Optional async delivery for long-running workflows (e.g., approvals, candidate status changes)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume HR data sync and recruiting/time-off processing
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as Employee Central (Persons, Employments, Job Info), Recruiting (Requisitions, Candidates, Applications), Time Management (Time Off, Timesheets), and Learning (Assignments, Completions), subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth via SAP IAS when enabled. Sessions and CSRF tokens are refreshed automatically with secure challenge handling.
Yes. We can normalize effective-dated job info, pay components, and absence data to match your payroll or analytics schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with ADP and enterprise data platforms.
Yes. We support downloading and uploading attachments via signed uploads, with checksum validation and time-limited URLs. Candidate application states, time-off approvals, and audit metadata are modeled explicitly in our normalized responses.