HTTP Webhook Integration

Integrating with the UniSignIn platform allows you to subscribe to user profile change events. These events are triggered when a user profile is created or updated. You can receive these events using one or multiple HTTP API endpoints.

Subscribing to User Profile Change Events

You can subscribe to user profile change events to stay updated when a user profile is created or modified. This integration enables real-time synchronization of user data with your application.

Example User Profile JSON

Below is an example of the JSON payload sent to your HTTP API endpoint when a user profile change event occurs:

{
  "uuid": "4e027a0f-e18a-8fba-82a4-02a880a2244c",
  "first_name": "First",
  "last_name": "Last",
  "login_date": 1719236490094,
  "login_social_provider": "google",
  "uid": 948625086,
  "email": "[email protected]"
}

Data Fields and Mapping

The data fields included in the JSON payload depend on the features enabled on your account and the Data Schema you have defined for collecting first-party data. You can view and manage these fields in the User Data -> Data Schema section of the UniSignIn platform.

Authentication of Your HTTP API Endpoint

To ensure the security of your HTTP API endpoint, you can protect it using an authentication secret. This secret allows you to verify that incoming events are genuinely from the UniSignIn platform.

Verifying the Authentication Header

Each event sent to your endpoint will include an Authentication HTTP header. You should verify this header to confirm the authenticity of the event. This verification helps to ensure that the data you receive is secure and trustworthy.

Historical User Profile Syncing

If you need to re-sync all user profiles to your HTTP API endpoint in a batch, please contact your account manager. They can assist you in setting up the historical data sync to ensure your system is up-to-date with all user profiles.

This integration ensures that your application remains synchronized with the latest user data, enhancing the overall user experience and maintaining data consistency.