Skip to main content
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.

​
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.

1

Sign in to OpenStreetMap

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.
2

Open the OAuth 2 Applications page

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.
3

Configure the application

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.
4

Select permissions and create the application

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.
5

Save and copy your credentials

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:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • 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.