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.

Note: you can also open the page directly —
Production or
Sandbox.

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 that match the StackOne actions you plan to use, then click Create Oauth2 application. Only the scopes shown in the Scopes Selected panel are required for your selected actions — grant the full list below only if you want every StackOne action available:

  • Read user preferences (read_prefs) and Modify user preferences (write_prefs) — user preference actions
  • Modify the map (write_api) and Comment on changesets (write_changeset_comments) — element, changeset, and changeset-comment write actions
  • Read private GPS traces (read_gpx) and Upload GPS traces (write_gpx) — GPS trace actions
  • Modify notes (write_notes) — note write actions; Redact map data (write_redactions) — optional, only for moderator/Data Working Group redaction actions
  • Read, update status and delete user messages (consume_messages) and Send private messages to other users (send_messages) — private message actions
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.