Skip to main content

Registering an OAuth app

Register a private app in the Scoro Developer Portal. A private app works only on the Scoro sites listed in its Site URLs, up to 3.

1

Create the app

Sign in to the Scoro Developer Portal, then click Create app.

  • Name the app StackOne Integration.
  • App type: Private
  • Authentication type: OAuth. It can’t be changed after the first save.
2

Set the callback and site URLs

Both lists are on the Setup tab.

  • Callback URLs: the Callback URL from your Connector Profile
  • Site URLs: the address of each Scoro site that will connect
  • Format: https://{site}.scoro.com
  • Example: https://acme.scoro.com
  • To connect any customer’s site, switch the app to Public and complete App Store profile and Submit for review. Once Scoro publishes it, any site can connect.
3

Set the access

Enables actions: Create Activity Type, Create Bill, Create Calendar Event, Create Company, Create Expense, Create Invoice, Create Invoice Payment, Create Order, Create Person, Create Product, Create Project, Create Project Phase, Create Quote, Create Status, Create Tag, Create Task, Create Task Comment, Create Tax Rate, Create Time Entry, Delete Calendar Event, Delete Company, Delete Invoice, Delete Order, Delete Person, Delete Project, Delete Quote, Delete Task, Delete Time Entry, Get Bill, Get Calendar Event, Get Company, Get Current User, Get Expense, Get Invoice, Get Order, Get Person, Get Project, Get Quote, Get Task, Get Time Entry, Get User, List Activity Types, List Bills, List Calendar Events, List Companies, List Custom Fields, List Expenses, List Invoice Lines, List Invoice Payments, List Invoices, List Order Lines, List Orders, List Payment Accounts, List Persons, List Products, List Project Phases, List Projects, List Quote Lines, List Quotes, List Statuses, List Tags, List Task Comments, List Task Time Entries, List Tasks, List Tax Rates, List Time Entries, List Users, Search Companies, Search Persons, Search Projects, Search Tasks, Update Calendar Event, Update Company, Update Invoice, Update Order, Update Person, Update Project, Update Quote, Update Task, Update Time Entry

Set each resource to its level in the scope list: :r is View, :rw is Edit and :rwd is Full.

  • Click Manage access.
  • Expand a group to set the level of one resource in it.
  • Leave every other group Off. Basic information is always on.
  • Click Save.
4

Copy the credentials

After the save, the app’s OAuth credentials card is on the Setup tab.

  • Click Generate OAuth credentials.
  • Copy the Client Secret into your Connector Profile. Scoro shows it only once, in a dialog, and it cannot be retrieved later.
  • Copy the OAuth Client ID into your Connector Profile.

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.