This call creates a new Social Login application. You can use the new application immediately for authenticating with OpenID-enabled providers (Google, AOL, and so on), but non-OpenID providers, such as Facebook, require additional configuration. After calling this function, use set_properties to enable these additional features.

Accepted Content-types

  • application/x-www-form-urlencoded
  • multipart/form-data

This endpoint includes the following methods:

  • POST



This endpoint supports Basic authentication. 

How to Create an Authentication String

Base URL

The base URL for this endpoint is your application domain followed by /partner/v2; for example:


You can find your application domain in the Social Login (Engage Dashboard) on the Settings page:

Example Request

curl -X POST \
    --data-urlencode apiKey=1234567891234567891234567891234567891234\
    --data-urlencode partnerKey=9876543219876543219876543219876\
    --data-urlencode email=test@example.com \
    --data-urlencode name=example_app \
    --data-urlencode domain=www.example.com \
      Running this command in Postman

Example Response

  "partnerresponse": {
    "stat": "ok",
    "apikey": "12345678912234567891234567891234567891234",
    "adminurl": "https://rpxnow.com/relying_parties/example",
    "inviteurl": "https://rpxnow.com/invite?code=0123645678901234567890123456789012345678901",
    "realm": "example.rpxnow.com",
    "appid": "01234567890123456789"

Query Parameters

Parameter Type Required Description
email string Yes Email address of the administrator for the new Social Login application.
domain string Yes Name of the domain being added.
format string API response data format. Allowed values are:
  • ​xml
  • json (the default value)
partnerKey string Yes Social Login partner key. This key can be found on the Janrain Dashboard.


200 OK

Response Fields

Field Type Description
stat dictionary This response is either ok or fail. If it's fail, it includes information on what went wrong. Otherwise, the remainder of these fields will be present.
apiKey dictionary The new application's apiKey.
adminUrl dictionary Your new application's administration URL. All administrators that have access to the parent app will have access to the new application.
inviteUrl dictionary Your new application's invite URL. The URL to use to invite new users to the application.
realm dictionary The fully qualified domain for your newly created application.
appId dictionary The application id for your new application.