> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # OpenStreetMap OAuth 2.0 connector profile – StackOne setup guide > Set up the OAuth 2.0 connector profile for OpenStreetMap in StackOne. One-time admin setup required before your users can link OpenStreetMap accounts via Hub. You must be signed in to an OpenStreetMap account to register an OAuth 2 application. Register the application in the same environment (Production or Sandbox) you intend to connect — the two have separate accounts and separate app registrations.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Register an OAuth 2 application

OpenStreetMap uses OAuth 2.0 for all editing and private-data operations. Create an OAuth 2 application in your OpenStreetMap account, select the permissions your integration needs, and copy the generated Client ID and Client Secret into StackOne.

Sign in to the OpenStreetMap site for the environment you are connecting. Enter your Email Address or Username and Password and click Log in (or use one of the third-party sign-in providers).

OpenStreetMap Log In page with the Email Address or Username field, Password field, and Log in button.

Open your account's OAuth 2 Applications page and start a new registration. Click your user icon in the top-right corner, choose your account, then open the OAuth 2 Applications tab and click Register new application.

My Client Applications page with the OAuth 2 Applications tab and the Register new application link highlighted.

On the Register a new application page, fill in the application details:

  • Name — a name for your application, for example `StackOne`.
  • In Redirect URIs, enter StackOne's callback URL exactly: `https://api.stackone.com/connect/oauth2/openstreetmap/callback`
  • Leave Confidential application? ticked — StackOne is a confidential (server-side) client.
Register a new application form showing the Name field, Redirect URIs field with the StackOne callback URL, and the Confidential application checkbox.
Enables actions: Close Changeset, Close Note, Comment Changeset, Comment Note, Create Changeset, Create Gpx Trace, Create Node, Create Note, Create Relation, Create Way, Delete Gpx Trace, Delete Message, Delete Node, Delete Relation, Delete User Preference, Delete Way, Get Current User, Get Gpx Trace Data, Get Gpx Trace Details, Get Message, Get User Preference, Get User Preferences, Hide Changeset Comment, Hide Note, List Inbox Messages, List Outbox Messages, List Own Gpx Traces, Redact Node Version, Redact Relation Version, Redact Way Version, Reopen Note, Replace User Preferences, Send Message, Subscribe Changeset, Subscribe Note, Unhide Changeset Comment, Unsubscribe Changeset, Unsubscribe Note, Update Changeset, Update Gpx Trace, Update Message Status, Update Node, Update Relation, Update Way, Upload Changeset

In the Permissions section, tick the permissions this integration needs, then click Create Oauth2 application. Grant the following permissions so every StackOne action can run:

  • Read user preferences (`read_prefs`) and Modify user preferences (`write_prefs`)
  • Modify the map (`write_api`) and Comment on changesets (`write_changeset_comments`)
  • Read private GPS traces (`read_gpx`) and Upload GPS traces (`write_gpx`)
  • Modify notes (`write_notes`) and Redact map data (`write_redactions`)
  • Read, update status and delete user messages (`consume_messages`) and Send private messages to other users (`send_messages`)
Permissions checklist with the required permissions ticked and the Create Oauth2 application button highlighted.

After you create the application, OpenStreetMap shows its Client ID and Client Secret. Copy both values into the StackOne Connector profile.

  • Copy the Client ID value and paste it into the Client ID field in the StackOne Connector profile.
  • Copy the Client Secret value and paste it into the Client Secret field in the StackOne Connector profile.
  • The Client Secret is only displayed once — the page warns Make sure to save this secret - it will not be accessible again. Copy it before leaving the page.
  • The Scopes field in the StackOne Connector profile is optional — leave it blank to request the full set of permissions, or enter a space-separated list to request only specific scopes.
Application registered page showing the Client ID and Client Secret rows (values redacted) and the save-this-secret warning.
## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for OpenStreetMap: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  • Click + Connector Profile
  • Search for and select OpenStreetMap
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
 Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for OpenStreetMap.