Skip to main content

How to whitelist a domain for the redirect

  • Updated

When using Securitize ID, it’s important to whitelist the URLs you want to redirect your users to after they complete login or signup. If the URL isn’t whitelisted, the redirect won’t work.

No worries — we’ll walk you through the process step by step! 😊

✅ Why You Need to Whitelist

For security reasons, only approved (whitelisted) URLs can be used for redirection. This helps protect your investors and ensures that users are safely sent back to your platform.

🔧 How to Whitelist Your URL

You can whitelist your URL by sending a PATCH request to update your application settings.

Here’s the sample curl command you’ll use:

curl --location --request PATCH 'https://connect-gw.{environment}securitize.io/api/config/v1/{domainId}' \
--header 'Authorization: {secret}' \
--header 'Content-Type: application/json' \
--data '{body}'

📄 Parameters Explained:

  • {environment}: Leave empty for production, or use ".sandbox" for the sandbox environment.
  • {domainId}: Your application’s client ID (provided by Securitize)
  • {secret}: Your application secret (provided by Securitize)
  • {body}: The configuration details you’ll send (example below)

📝 Example Body:

{
  "appIcon": "https://soccerplays.invest.securitize.io/assets/general-images-dark",
  "appName": "Soccer Plays",
  "redirectUrls": [
    "https://[yourdomain.com]/*"
  ]
}

You Can Update:

  • appIcon: The icon displayed on the Securitize ID login screen.
  • appName: The name of your app or issuer displayed on the login screen.
  • redirectUrls: The list of domains your app is allowed to redirect to. You can add multiple URLs like this:
    "redirectUrls": ["https://site1.com/*", "https://site2.com/*"]

⭐️ Important: Don’t Forget the Wildcard!

Make sure to add the wildcard symbol (*) at the end of your URL, like this:

https://[yourdomain.com]/*

This ensures you can redirect users to:

https://[yourdomain.com]/anything-you-need-here

👉 You can even include parameters in the redirect URL if needed!

Related articles