Developer Portal – build your integration with Scoro

Scoro’s Developer Portal is the central hub for developers looking to integrate with Scoro. Join our developer ecosystem to build:

• Custom internal solutions for your site to automate your company’s workflows or pull data from various third-party sources that don’t have a dedicated integration with Scoro.
• Create public integrations with Scoro and promote your solution in the Scoro App Store to thousands of consultancies, agencies, and professional services using Scoro for project, resource, and financial management.

There are no fees to sign up for our Developer Portal and to build, launch, and list your app on Scoro App Store. We provide API access, documentation, and go-to-market support at no cost.

For more information on the benefits of building apps for Scoro and what you can build, see our Integrate with Scoro page.

1. What applications can you build on Scoro?

You can use Scoro’s Developer Portal to create two kinds of integrations:

• Private apps for internal use on your own site
• Public apps listed on Scoro App Store

1.1. Private apps

Private applications are custom integrations built specifically for your internal business needs. By building a private app, you can leverage Scoro’s infrastructure to automate unique workflows and connect internal tools directly to your workspace. This allows you to tailor Scoro to your team’s specific operational requirements, ensuring seamless data flow and efficient processes.

Creating a private app largely involves only two steps (see the detailed guide here):

1. Register your app in the Developer portal
2. Build and test your app

Unlike public apps that are submitted for listing in the Scoro App Store, private apps don’t require a formal review by the Scoro team.

1.2. Public apps

Public applications are apps designed to be listed on the Scoro App Store and shared with the wider Scoro community.

By building a public app, you can showcase your solution to thousands of professional services, consultancies, and agencies globally. When your app connects with Scoro, you tap into a growing customer base actively looking for solutions to extend their operational capabilities.

Public app creation shares the same steps as for private apps, but with one additional step (see the detailed guide here):

1. First, you register your app in the Developer Portal.
2. Then, you build and test it.
3. Lastly, you submit your app’s Marketplace listing for a review. All public apps undergo a formal review process by the Scoro team to ensure they meet our security and quality standards before being enabled in our Marketplace. Learn more about the review process in the Review process for public integrations section.

2. Creating a new application

Step 1: Register your app in the Developer Portal

Before you begin building your application, you need to register it as a new app in Scoro’s Developer Portal:

1. Log in to your Developer Portal account or create a new one.
2. Once you’ve logged in, navigate to the Apps section and click the Add button.
   
3. Next, fill out the general details for your application’s integration card in Scoro App Store: 
   • App name – enter the name of your application.
   • App type – select whether your app is Public (an app available on Scoro App Store for other Scoro users) or Private (for internal use only on your site).
   • App icon – upload an icon for your app.
   • Category – select the category you want your application’s integration card to appear in.

   • Short description – enter a brief description of what your integration does (max. 1-2 sentences).

     Note! Check the preview on the right side to see how your app details will look in the marketplace.
4. Select the authentication method your app will use to authenticate with the Scoro API:
   • User token (recommended): A flexible and secure method that uses a token generated by a user inside their Scoro site. To obtain your user token, you’ll need to make an authentication request to the Scoro API using your Scoro credentials. You can find the endpoints on our API documentation > User Authorization.
   • API Key: This is a legacy method used only for specific use cases. If you require an API key, please send a request to app.partners@scoro.com with more context on why you prefer an API key over a user token for authentication.
   • OAuth: This authentication method is used only for MCP apps.
5. Click Save.
   

After saving your new app, you will be redirected to the app list, where you can access the App ID for the new app you just created. The App ID is used for all public integrations and must be sent as an HTTP header in all API calls.

If the Scoro-app-id header is missing or incorrect, the API will return a 401 Unauthorized error.

Step 2: Build and test your app

Once you’ve registered your new app, you need a Scoro test site and an authentication token to start building:

1. Create a Scoro test site:
   If you don’t already have a Scoro test site, go to our website and click the Try for free button to create a new trial site. The free trial lasts 14 days. If you’d like to extend it, reach out to us at app.partners@scoro.com.
2. Get your authentication token:
   • To obtain your user token, you’ll need to make an authentication request to the Scoro API using the credentials for your Scoro test site. You can find endpoints on our API documentation > User Authorization.
   • If you were approved for an API key, use the one our team provided.
3. (optional) Connect your test site to the Developer Portal:
   If you’re using a user token as the authentication method and you want to access your app on your test site’s Integrations page (Settings > Site settings > Integrations), you’ll need to connect your test site to your Developer Portal account. In the Developer Portal, click the Settings icon at the bottom-left corner of the screen, then enter the Site URL and User token.

Step 3 (for public apps only): Submit your app to Scoro App Store

If you’ve registered your app for public use, you need to complete the details for your app listing in Scoro App Store:

1. Click on the app in the Developer Portal to modify it.
2. Open the Marketplace profile tab and provide the details for your app’s listing in Scoro App Store – this includes details like:
   • Screenshots that show what your app looks like
   • Overview of what your app does and how it works
   • Key benefits of connecting your app to Scoro
   • Demo video from YouTube or Vimeo
   • Developer details (logo, name, website URL)
   • Support resources (URL to help materials, customer support e-mail)
   • Terms of use and privacy policy URLs
     
3. Then, open the Submit for review tab and provide information about your app’s security practices – this includes details like:
   • Certifications and accreditations
   • Penetration testing
   • Backup and logging practices
   • Data protection practices (personal data handling, incidents, data hosting location, and data sub-processors and their locations)
   • Data processing agreement
     
4. Once you’ve provided all the required information, click Save to trigger the review process for your app.

You can see your application’s status in the Developer Portal under the App Status column. Learn more about the public app review process in the next section.

3. Review process for public integrations

While private apps can be used without Scoro’s team review, all public applications are reviewed by the Scoro team before they can be enabled in the Scoro App Store and made available to any Scoro user.

Once you submit your public app for review from the Developer Portal, it enters our review queue to ensure security and quality:

1. Security check: Our team reviews your security questionnaire to verify how the user data is handled. We’ll contact you via email if more details are needed. 
2. Demo and testing: After passing the security check, we’ll contact you to schedule a live demo and request test credentials to validate your app’s functionality.
3. Listing content review: Lastly, we check your public listing content (descriptions, visuals, links) to ensure it meets our quality standards.

We’ll let you know as soon as our team has reviewed everything above and when your app is live on the Scoro App Store.

The review process typically takes around 30 days, though in some cases it can take longer. If you don’t hear from us within this timeframe or need to provide additional information about your app, please reach out to us at app.partners@scoro.com.

4. Managing your live application

After your app is live on Scoro App Store, you can manage it directly from the Developer Portal.

4.1. Editing your app listing

To edit your app listing details, such as the app’s description or screenshots:

1. In the Apps tab, click on the name of the app you want to modify.
2. Open the Submit to review tab and add the necessary details in the Additional information field.
3. When finished, click the Request to re-publish button to submit your listing changes for another review. This will notify our team, and we’ll review the changes you submitted before publishing them to the Scoro App Store. 

Once you confirm the changes to your app, they don’t go live right away – our team will be notified and review them. We will inform you once your app’s listing is updated in the Scoro App Store.

4.2. Unpublishing your public app

If you’d like to unpublish your public app and remove it from Scoro App Store, please send your request to app.partners@scoro.com, and we’ll let you know of the next steps.