While submitting a System for Cross-domain Identity Management (SCIM) enabled application to the Okta Integration Network (OIN) via the OIN Wizard, developers may encounter the error mentioned below when attempting to use integration variables in the SCIM Base URL field.

The expression language syntax is incorrect. Update the syntax

• Okta Integration Network (OIN) Wizard
• System for Cross-domain Identity Management (SCIM) Integrations
• Integration Variables

This typically occurs when developers attempt to use standard Okta Expression Language (for example, ${subdomain}) to support multi-region environments (for example, US/EU) or self-hosted instances. The OIN Wizard enforces a specific string concatenation syntax for the SCIM Base URL field that differs from the standard Expression Language used elsewhere in Okta.

To resolve the syntax error and correctly pass customer-specific domains or regions to the SCIM Base URL, follow these steps:

1. Define the Variable
   1. In the OIN Wizard, go to the Integration Variables tab.
   2. Create the variable (for example, create a variable named subdomain or api_host).

NOTE: Variable names must be lowercase alphanumeric characters, may include underscores (for example, subdomain_id) and must start with a letter.

2. Format the SCIM Base URL
   1. When entering the SCIM Base URL, do not use the ${...} syntax. Instead, use single quotes ' for static text and the plus sign + to join them with the variable.
   2. Prefix the variable name with app..

Examples

• Partial Variable (Subdomain): If just a subdomain is needed from the customer (for example, tenant.example.com):

  'https://' + app.subdomain + '.example.com/scim/v2'

• Full Host Variable (Multi-region/Self-hosted): If the full API host is needed from the customer (for example, api.eu.example.com or selfhosted.company.com):

  'https://' + app.api_host + '/scim/v2'

Related References

• Submit an app to the OIN: SCIM Properties

• Dynamic properties with Okta Expression Language