Auth0

Ingest your event data from Auth0 into RudderStack.

Auth0 is a popular solution used by many companies to add authentication and authorization services to their applications.

You can send your Auth0 authentication and user behavior-related events by adding a custom webhook that points to RudderStack.

This guide will help you set up Auth0 as a source in RudderStack.

Getting started

Follow these steps to set up your Auth0 source in the RudderStack dashboard:

  1. Go to your RudderStack dashboard and click Add Source. From the list of Event Streams sources, select Auth0.
  2. Assign a name to your source and click Continue.
  3. Your Auth0 source is now configured. Note the Webhook URL in the Settings tab:
Auth0 source webhook URL
  1. Next, log in to your Auth0 dashboard.
  2. Go to Monitoring > Streams > Create Log Stream > Custom Webhook:
Auth0 source webhook URL
  1. Name your custom webhook. In the Payload URL field, enter the webhook URL obtained in Step 3.
Auth0 custom webhook settings
  1. Configure the other webhook settings as required.
info
You can also filter the events sent to your custom webhook by category. For more information on these categories, refer to the Auth0 documentation.
  1. Click Save to save the custom webhook.

Event transformation

RudderStack ingests Auth0 events as track, group, and identify calls.

RudderStack converts the Auth0 payload into an identify event if the Auth0 payload contains the event type as ss.

RudderStack converts the Auth0 payload into a group event if the Auth0 payload contains the description as Add members to an organization.

RudderStack converts the rest of the events as track events.

info
RudderStack ingests the events related to adding members to an organization as group calls and the signup-related events as identify calls. All the other events are ingested as track calls.

RudderStack maps the following properties from the Auth0 event payload to RudderStack properties for all identify, track, and group events:

Auth0 PropertyRudderStack Property
auth0_clientproperties.auth0_client
client_idproperties.client_id
client_nameproperties.client_name
connectiontraits.connection
connection_idtraits.connection_id
descriptionproperties.description
detailsproperties.details
details.auth.user.emailcontext.traits.email
details.auth.user.namecontext.traits.name
log_idproperties.log_id
isMobileproperties.is_mobile
ipcontext.request_ip
user_namecontext.traits.user_name
user_agentcontext.userAgent
user_iduserId
context.traits.userId

Debugging

Events not flowing

If you are unable to see any events flowing from the Auth0 API webhooks to RudderStack, you can troubleshoot the issue by viewing the API webhooks logs. To do so, go to your Auth0 dashboard and navigate to Monitoring > Logs.

Refer to the Auth0 documentation for more information on troubleshooting your webhook.

Update userId format

Use the Clean Auth0 userId transformation template to update your userId format.



Questions? Contact us by email or on Slack