Skip to main content

How can we help you?

Search

SAML SSO - Auth0 Configuration

Set up single sign-on (SSO) for ContactMonkey using Auth0 as your SAML 2.0 identity provider. ContactMonkey supports both Service Provider (SP) and Identity Provider (IdP) initiated SAML 2.0.

Before You Begin

Contact ContactMonkey Technical Support first. You'll need two pieces of information from our team before you can complete this setup:

  • Application Callback URL - The URL where Auth0 sends authentication responses
  • SP Entity ID - Your unique ContactMonkey organization identifier

What you'll need:

  • Admin access to your Auth0 dashboard
  • The Application Callback URL from ContactMonkey support
  • The SP Entity ID from ContactMonkey support

Please also review this article for requirements and frequently asked questions.

Configure Auth0 for ContactMonkey

Step 1: Create Your SAML Application

  1. Log in to your Auth0 dashboard
  2. Navigate to Applications → Applications in the sidebar
  3. Click Create Application
  4. Enter a name for your application (example: "ContactMonkey SAML")
  5. Click Continue

Step 2: Configure Application Settings

  1. Click Settings
  2. Set Application Type to Regular Web Application
  3. (Optional) Upload a logo for the application
  4. Click Save Changes

Step 3: Enable and Configure SAML2 Addon

  1. Click Addons
  2. Click SAML2 to enable it
  3. Click the Settings tab within the SAML2 addon

Step 4: Edit SAML Settings

  1. In the Application Callback URL field, paste the URL provided by ContactMonkey Technical Support
  2. In the Settings JSON editor, uncomment and update the following lines:
    • Remove // for audience and change it to: "audience:" "YOUR_ORG_AUDIENCE",
    • Remove // for mappings and its closing }, in line 12
    • Remove // for email and change it to: "email": "email",
    • Remove // for given_name and change it to: "given_name": "first_name"
    • Remove // for family_name and change it to: "family_name": "last_name",
    • Remove // for signatureAlgorithm and change it to: "signatureAlgorithm": "rsa-sha256",
    • Remove // for digestAlgorithm and change it to: "digestAlgorithm": "sha256",
  3. Scroll to the bottom and click Enable
  4. Click Save
auth0-6.png

Step 5: Download Identity Provider Metadata

  1. Click the Usage tab within the SAML2 addon
  2. Click to download the Identity Provider Metadata file
  3. Send this metadata file to ContactMonkey Technical Support via your open support ticket
auth0-7.png

Once our team receives your metadata file, they'll complete the configuration on the ContactMonkey side and confirm when SSO is active.

Troubleshooting

Can't find the Application Callback URL
Check your email correspondence with ContactMonkey Technical Support. If you can't locate it, reply to your support ticket to request it again.

JSON editor won't save changes
Ensure you've clicked both Enable at the bottom of the Settings tab and Save Changes. Both actions are required.

Metadata file won't download  
Make sure you've enabled the SAML2 addon and saved all settings before attempting to download metadata.

See Also

Related articles