FusionAuth developer image
FusionAuth developer logo
  • Back to site
  • Expert Advice
  • Blog
  • Developers
  • Downloads
  • Account
  • Contact sales
Navigate to...
  • Welcome
  • Getting Started
  • 5-Minute Setup Guide
  • Release Notes
  • Core Concepts
    • Overview
    • Users
    • Roles
    • Groups
    • Entity Management
    • Registrations
    • Applications
    • Tenants
    • Identity Providers
    • Key Master
    • SCIM
    • Search
    • Authentication and Authorization
    • Integration Points
    • Localization and Internationalization
    • Editions and Features
    • Roadmap
  • Installation Guide
    • Overview
    • System Requirements
    • Server Layout
    • Cloud
    • Cluster
    • Docker
    • Fast Path
    • Kubernetes
      • Overview
      • Deployment Guide
      • Minikube Setup
      • Amazon EKS Setup
      • Google GKE Setup
      • Microsoft AKS Setup
    • Kickstart™
    • Homebrew
    • Packages
    • Database
    • FusionAuth App
    • FusionAuth Search
    • Common Configuration
  • Admin Guide
    • Overview
    • Account Portal
    • Config Management
    • Licensing
    • Monitoring
    • Proxy Setup
    • Securing
    • Technical Support
    • Troubleshooting
    • Upgrading
  • Migration Guide
    • Overview
    • General
    • Auth0
    • Keycloak
    • Amazon Cognito
    • Firebase
    • Tutorial
  • APIs
    • Overview
    • Authentication
    • Errors
    • Actioning Users
    • API Keys
    • Applications
    • Audit Logs
    • Connectors
      • Overview
      • Generic
      • LDAP
    • Consents
    • Emails
    • Entity Management
      • Overview
      • Entities
      • Entity Types
      • Grants
    • Event Logs
    • Families
    • Forms
    • Form Fields
    • Groups
    • Identity Providers
      • Overview
      • Links
      • Apple
      • External JWT
      • Epic Games
      • Facebook
      • Google
      • HYPR
      • LinkedIn
      • Nintendo
      • OpenID Connect
      • SAML v2
      • SAML v2 IdP Initiated
      • Sony PlayStation Network
      • Steam
      • Twitch
      • Twitter
      • Xbox
    • Integrations
    • IP Access Control Lists
    • JWT
    • Keys
    • Lambdas
    • Login
    • Message Templates
    • Messengers
      • Overview
      • Generic
      • Kafka
      • Twilio
    • Multi-Factor/Two Factor
    • Passwordless
    • Reactor
    • Registrations
    • Reports
    • SCIM
      • Overview
      • SCIM EnterpriseUser
      • SCIM Group
      • SCIM Service Provider Config.
      • SCIM User
    • System
    • Tenants
    • Themes
    • Users
    • User Actions
    • User Action Reasons
    • User Comments
    • Webhooks
  • Client Libraries
    • Overview
    • Dart
    • Go
    • Java
    • JavaScript
    • .NET Core
    • Node
    • OpenAPI
    • PHP
    • Python
    • Ruby
    • Typescript
  • Themes
    • Overview
    • Examples
    • Helpers
    • Localization
    • Template Variables
  • Email & Templates
    • Overview
    • Configure Email
    • Email Templates
    • Email Variables
    • Message Templates
  • Events & Webhooks
    • Overview
    • Writing a Webhook
    • Securing Webhooks
    • Events
      • Overview
      • Audit Log Create
      • Event Log Create
      • JWT Public Key Update
      • JWT Refresh
      • JWT Refresh Token Revoke
      • Kickstart Success
      • User Action
      • User Bulk Create
      • User Create
      • User Create Complete
      • User Deactivate
      • User Delete
      • User Delete Complete
      • User Email Update
      • User Email Verified
      • User IdP Link
      • User IdP Unlink
      • User Login Failed
      • User Login Id Duplicate Create
      • User Login Id Duplicate Update
      • User Login New Device
      • User Login Success
      • User Login Suspicious
      • User Password Breach
      • User Password Reset Send
      • User Password Reset Start
      • User Password Reset Success
      • User Password Update
      • User Reactivate
      • User Registration Create
      • User Registration Create Complete
      • User Registration Delete
      • User Registration Delete Complete
      • User Registration Update
      • User Registration Update Complete
      • User Registration Verified
      • User Two Factor Method Add
      • User Two Factor Method Remove
      • User Update
      • User Update Complete
  • Example Apps
    • Overview
    • Dart
    • Go
    • Java
    • JavaScript
    • .NET Core
    • PHP
    • Python
    • Ruby
  • Lambdas
    • Overview
    • Apple Reconcile
    • Client Cred. JWT Populate
    • Epic Games Reconcile
    • External JWT Reconcile
    • Facebook Reconcile
    • Google Reconcile
    • HYPR Reconcile
    • JWT Populate
    • LDAP Connector Reconcile
    • LinkedIn Reconcile
    • Nintendo Reconcile
    • OpenID Connect Reconcile
    • SAML v2 Populate
    • SAML v2 Reconcile
    • SCIM Group Req. Converter
    • SCIM Group Resp. Converter
    • SCIM User Req. Converter
    • SCIM User Resp. Converter
    • Sony PSN Reconcile
    • Steam Reconcile
    • Twitch Reconcile
    • Twitter Reconcile
    • Xbox Reconcile
  • Identity Providers
    • Overview
    • Apple
    • Epic Games
    • External JWT
      • Overview
      • Example
    • Facebook
    • Google
    • HYPR
    • LinkedIn
    • Nintendo
    • OpenID Connect
      • Overview
      • Azure AD
      • Discord
      • Github
    • Sony PlayStation Network
    • Steam
    • Twitch
    • Twitter
    • SAML v2
      • Overview
      • ADFS
    • SAML v2 IdP Initiated
      • Overview
      • Okta
    • Xbox
  • Messengers
    • Overview
    • Generic Messenger
    • Kafka Messenger
    • Twilio Messenger
  • Connectors
    • Overview
    • Generic Connector
    • LDAP Connector
    • FusionAuth Connector
  • Self Service Account Mgmt
    • Overview
    • Updating User Data & Password
    • Add Two-Factor Authenticator
    • Add Two-Factor Email
    • Add Two-Factor SMS
    • Customizing
    • Troubleshooting
  • Advanced Threat Detection
    • Overview
  • Integrations
    • Overview
    • CleanSpeak
    • Kafka
    • Twilio
  • OpenID Connect & OAuth 2.0
    • Overview
    • Endpoints
    • Tokens
  • SAML v2 IdP
    • Overview
    • Google
    • Zendesk
  • Plugins
    • Plugins
    • Writing a Plugin
    • Custom Password Hashing
  • Guides
    • Overview
    • Advanced Registration Forms
    • Breached Password Detection
    • Multi-Factor Authentication
    • Multi-Tenant
    • Passwordless
    • Securing Your APIs
    • Silent Mode
    • Single Sign-on
  • Tutorials
    • Overview
    • User Control & Gating
      • Gate Unverified Users
      • Gate Unverified Registrations
      • User Account Lockout
    • Setup Wizard & First Login
    • Register/Login a User
    • Start and Stop FusionAuth
    • Authentication Tokens
    • Key Rotation
    • JSON Web Tokens
    • Prometheus Setup
    • Switch Search Engines
    • Two Factor (pre 1.26)
  • Reference
    • CORS
    • Configuration
    • Data Types
    • Known Limitations
    • Password Hashes

    User Identity Provider Link

    User Identity Provider Link

    This event has been available since 1.36.0.

    This event is generated when a user is linked to an Identity Provider.

    Event type
    user.identity-provider.link

    Event Scope

    This is a tenant scoped event.

    Transaction Compatibility

    This event is non-transactional. The event will succeed regardless of the webhook response status code.

    Event Body

    event.createInstant [Long]

    The instant that the event was generated.

    event.id [UUID]

    The unique Id of the event.

    event.identityProviderLink [IdentityProviderLink]

    The identity provider link created. See the Identity Provider Links API for property definitions and example JSON.

    event.info.data [Object]

    An object that can hold any information about the event that should be persisted.

    event.info.deviceDescription [String]

    The description of the device associated with the event.

    event.info.deviceName [String]

    The device name associated with the event.

    event.info.deviceType [String]

    The type of device associated with the event.

    event.info.ipAddress [String]

    The source IP address of the event.

    event.info.location.city [String]

    The city where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.location.country [String]

    The country where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.location.latitude [String]

    The latitude where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.location.longitude [String]

    The longitude where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.location.region [String]

    The geographic location where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.location.zipcode [String]

    The zip code where the event originated.

    Note: A paid edition of FusionAuth is required to utilize event info location.

    event.info.os [String]

    The operating system associated with the event.

    event.info.userAgent [String]

    The user agent associated with the event.

    event.tenantId [UUID]

    The unique tenant identifier.

    event.type [String]

    The event type, this value will always be user.identity-provider.link.

    event.user [User]

    The user that has been linked. See the Users API for property definitions and example JSON.

    Example Event JSON
    {
      "event": {
        "createInstant": 1505762615056,
        "id": "e502168a-b469-45d9-a079-fd45f83e0406",
        "identityProviderLink" : {
          "displayName" : "Google",
          "identityProviderId" : "82339786-3dff-42a6-aac6-1f1ceecb6c46",
          "identityProviderUserId" : "42",
          "insertInstant" : 1505762615057,
          "lastLoginInstant" : 1505762615057,
          "tenantId" : "e872a880-b14f-6d62-c312-cb40f22af465",
          "userId" : "00000000-0000-0001-0000-000000000000"
        },
        "info" : {
          "ipAddress" : "42.42.42.42",
          "location" : {
            "city" : "Denver",
            "country" : "US",
            "displayString" : "Denver, CO, US",
            "latitude" : 39.77777,
            "longitude" : -104.9191,
            "region" : "CO"
          },
          "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Safari/537.36"
        },
        "tenantId": "e872a880-b14f-6d62-c312-cb40f22af465",
        "type": "user.identity-provider.link",
        "user": {
          "active": true,
          "connectorId": "e3306678-a53a-4964-9040-1c96f36dda72",
          "email": "example@fusionauth.io",
          "id": "00000000-0000-0001-0000-000000000000",
          "lastLoginInstant": 1471786483322,
          "passwordChangeRequired": false,
          "passwordLastUpdateInstant": 1471786483322,
          "registrations": [
            {
              "applicationId": "10000000-0000-0002-0000-000000000001",
              "id": "00000000-0000-0002-0000-000000000000",
              "insertInstant": 1446064706250,
              "lastLoginInstant": 1456064601291,
              "roles": [
                "user"
              ],
              "usernameStatus": "ACTIVE"
            }
          ],
          "tenantId": "e872a880-b14f-6d62-c312-cb40f22af465",
          "usernameStatus": "ACTIVE",
          "verified": true
        }
      }
    }

    Feedback

    How helpful was this page?

    See a problem?

    File an issue in our docs repo

    © 2021 FusionAuth
    Subscribe for developer updates