Resolve Okta Permission Error When Using Mappings API With Terraform
Mar 11, 2026
Administration
Okta Identity Engine
Okta Classic Engine
Overview
A permission error occurs when using the Mappings API with Terraform because a required feature is missing. An administrator resolves the error by contacting Okta Support to enable the feature. The administrator receives the following permission error when attempting to use the Mappings API with Terraform:
Error: failed to find profile mapping source: The API returned an error: You do not have permission to access the feature you are requesting.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Profile Mappings
- Terraform Provisioning
Cause
Why does the Mappings API return a permission error?
A missing feature flag in the Okta tenant causes this error.
Solution
How does the administrator resolve the Mappings API permission error?
Follow the step below to enable the required feature.
-
Open a ticket with Okta Support and reference the current article in the support case to enable the feature.
