Configure general settings

On This Page

To start your integration submission, open the OIN Manager (opens new window) and click Start Submission Form.

Sign in using your development org credentials and click Add New Submission to create a new submission instance.

If you want to review an in-progress submission, click View beside the name of your integration.

If you need to update an integration, see Update your published integration.

In the General Settings page, you need to fill in the basic information about your integration:

App information

  • Does your app exist in the OIN? — if your integration already exists in the OIN, provide the Existing OIN app name so that the Okta OIN team can locate it.

  • What changes are you making to the existing OIN integration? — if your integration already exists in the OIN, summarize the changes that you are requesting in your update. This summary helps the Okta OIN team address your changes.

  • App name — provide a name for your integration. This is the main title used for your integration in the OIN.

  • App website — provide a link to your product or service homepage, or a specific location on your website where users can learn more about your integration.

  • App category — specify one or more categories that Okta will use to categorize your integration in the OIN catalog. Click Add Another to choose up to three categories.

  • App description — give a general description of your application and what the Okta integration does. For examples, see the overview section for any of the integrations listed on the OIN (opens new window).

  • App icon — upload a PNG, JPG, or GIF file of a logo to accompany your integration in the catalog. The logo file must be smaller than 1 MB in size. For best results, use a PNG image with a transparent background, a landscape orientation, and use a minimum resolution of 420 x 120 pixels to prevent upscaling.

Customer support

  • Public support contact — include a public point of contact (support email or phone number) for users who need assistance with your integration. You can also include a link to a FAQ or troubleshooting guide to help with common issues. This information is shared with the customers in the OIN catalog description.

  • Escalation support contact — this should be an email distribution list for Okta to use when contacting your company about your integration. It can be a phone number, but ideally when there is an issue with your integration, Okta wants to reach as many people as possible without creating any bottlenecks. Make sure that the contact provided here is not a generic contact such as or a 1-800 number. The escalation contact should be a contact list that Okta can reach out to in any emergencies. This contact information is not shared with customers.

Test account

The Okta OIN team requires a dedicated account on your application to run their tests. This account needs to be kept active beyond the submission period in case Okta needs to update or troubleshoot a submission.

  • Test account URL — this is a static URL for Okta to sign on to your application. The account credentials you provide below must work for this URL.

  • Test account username or email — the account name for Okta to use to sign on to your application. Our preferred account name is

  • Test account password — password for the test account.

  • Additional instructions — include any other information that you think the Okta OIN team needs to know about your integration, the test account, or the testing configuration.