Connectors

HR & People

SAP SuccessFactors

HR suite: employee, organization, and talent data through OData and REST
Signs in with
OAuth 2.0 sign-in
Runs on
Cloud or On-Prem Worker
Operations
35
Ready-made triggers
0

Connect SAP SuccessFactors

  1. In Neblex open Connect › Connections and click New Connection.
  2. Search for SAP SuccessFactors and give the connection a clear name.
  3. Fill in the fields. Secret values are encrypted and never shown again.
  4. Click Test, then Create Connection.
For services offered under Connect a Service you only sign in and approve access. Otherwise use Connect with OAuth2 with your own OAuth app. See Authorize with OAuth.
FieldWhat to enter
API serverRequiredYour data center's API server without https://, from the list of SAP SuccessFactors API servers (for example api4.successfactors.com or api2.successfactors.eu).Example: api4.successfactors.com
Token endpointRequiredhttps://<API server>/oauth/token on the same API server.Example: https://api4.successfactors.com/oauth/token
Company IDRequiredYour SAP SuccessFactors company ID; sent as company_id on the token request.
Client ID (API key)RequiredThe API key of the client application registered in Manage OAuth2 Client Applications.
User IDRequiredThe SAP SuccessFactors user ID the API calls run as (the assertion's NameID).
Private keyRequiredSecretThe private key of the X.509 certificate registered with the client application (PKCS#8, PEM or the base64 key SAP SuccessFactors generates). It signs each SAML assertion locally and never leaves the connection.
Assertion audienceRequiredThe SAML assertion's audience; SAP SuccessFactors accepts any non-empty value.

Use it in a flow

  1. Open a flow, open the node library and search for SAP SuccessFactors.
  2. Drag it onto the canvas and choose an Operation and your connection.
  3. Map the operation's fields from earlier steps, or click Map with Matt.
  4. Use Test this step to see what it returns, then save.

To start a flow from SAP SuccessFactors without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if SAP SuccessFactors can send webhooks, a Webhook trigger receives them at its own URL.

Operations

35 operations in 7 groups. Each one is a step you can add to a flow.

OAuth1
Validate the access tokenvalidateAccessTokenGETReturns the current access token's type and remaining lifetime.
OData v2 entities10
Count entitiescountEntitiesGETReturns the number of entities matching the filter as plain text.
Create an entitycreateEntityPOSTInserts an entity (insert operation).
Delete an entitydeleteEntityDELETEDeletes an entity by its key predicate.
Get an entity by keygetEntityGETReads one entity by its key predicate.
Query a navigation propertyqueryNavigationGETReads the entities a navigation property of one entity points to, with the query options; follows next to the last page.
Query entitiesqueryEntitiesGETQueries an entity set with $filter, $select, $expand and $orderby, client-side ($top, $skip) or server-side (snapshot, cursor) paging, and the MDF effective-date parameters; follows next...
Replace an entityreplaceEntityPUTReplaces an entity; properties not in the payload reset to their defaults (replace operation).
Update an entity (merge)mergeEntityPOSTUpdates only the given properties of an entity (merge operation).
Upsert entitiesupsertEntitiesPOSTInserts or updates one or many records of any entities in one call; the response reports each record's status, editStatus, httpCode and message.
Upsert entities with scoped metadataupsertEntitiesScopedPOSTUpsert that loads only the named entities' metadata, for a faster first response.
OData v2 function imports2
Call a function import (GET)callFunctionImportGETCalls a GET function import with its parameters.
Call a function import (POST)callFunctionImportPostPOSTCalls a POST function import with its parameters.
OData v2 links4
Create or merge a linkcreateLinkPOSTAdds a link to a 1:n association or creates a 1:1 link.
Delete a linkdeleteLinkDELETERemoves the association between two entities; give the target key in the navigation property.
Query linksqueryLinksGETLists the entities an association of one entity links to.
Replace a linkreplaceLinkPUTReplaces a 1:1 link, or the keyed link of a 1:n association.
OData v2 metadata4
Get entity metadata as JSONgetEntityMetadataGETReturns one entity type's properties, navigation properties and their capabilities as JSON.
Get metadata of entity setsgetEntitySetsMetadataGETReturns the metadata (XML) of one or several comma-separated entity types.
Get the metadata documentgetMetadataGETReturns the whole OData v2 metadata document (XML).
Refresh the metadata cacherefreshMetadataGETRefreshes the instance's OData metadata cache after configuration changes.
OData v48
Create an OData v4 entity or invoke an actioncreateV4POSTCreates an entity, or invokes a bound or unbound action with its parameters as the body.
Delete an OData v4 entitydeleteV4DELETEDeletes an entity.
Get an OData v4 entity or call a functiongetV4GETReads one entity (resource with its key) or calls a bound or unbound function.
Get an OData v4 service's metadatagetV4MetadataGETReturns the service's metadata document; Prefer include-annotations=" " adds annotations.
Query an OData v4 entity setqueryV4GETQueries an entity set of an OData v4 service; follows @odata.nextLink to the last page.
Refresh an OData v4 service's metadatarefreshV4MetadataPOSTRefreshes the metadata of one OData v4 service.
Replace an OData v4 entityreplaceV4PUTReplaces an entity.
Update an OData v4 entityupdateV4PATCHMerges the given properties into an entity.
REST6
Create a REST resourcecreateRestPOSTCreates a resource or runs a REST action.
Delete a REST resourcedeleteRestDELETEDeletes a REST resource.
Get a REST resourcegetRestGETReads one REST resource.
List a REST resourcelistRestGETReads a REST collection and follows the Link rel="next" header to the last page.
Replace a REST resourcereplaceRestPUTReplaces a REST resource.
Update a REST resourceupdateRestPATCHPartially updates a REST resource.