Welcome to the upSWOT Developer Platform! Use our APIs to create a seamless experience for your users!
upSWOT APIs are RESTful, featuring predictable and resource-oriented URLs with standard HTTP response codes, authentication, and verbs. They are stateless. All requests are validated against the API token, which can be obtained using the get token
method.
With upSWOT API, you can create a connection link to let clients share their business data or use Webhooks to send it to a specific URL or web application when it rolls in. Furthermore, you can leverage raw and normalized business data to build internal solutions and ready-to-use APIs to create custom experiences for your end users.
Use Cases
Why you should use our REST APIs:
- Build unique UI/UX solutions with our APIs based on Raw, Normalized, and Ready-To-Use data.
- Utilize data from 100+ SaaS business applications using one API interface.
- Create a seamless experience for the end users to share business data securely.
Getting Started
This is where the magic begins! The following steps will help you get started with your journey toward creating some excellent integrations using the API:
- Get your Sandbox developer account.
- Obtain your JWT access token.
- Use the access token to make your API requests.
Follow these simple instructions to make your first call in minutes, or keep reading to learn more.
Host
upSWOT API has two base URLs for Sandbox and Production.
Custom Base URL
upSWOT API offers two deployment options: SaaS (upSWOT site) or CPE (customer premises equipment). Therefore, the host URL may vary for different environments.
Sandbox Base URL
For all sandbox API calls, use the following URL:
https://sandbox.upswot.com
Production Base URL
https://app.upswot.com
Tenants
upSWOT solution is available as SaaS supporting multi-tenancy architecture - an ecosystem in which a single environment can serve multiple tenants using a scalable architecture.
Within a multi-tenancy environment, all tenants share a single, common infrastructure and code base that is centrally maintained. Each tenant is integrated physically but separated logically. Here is the URL structure that upSWOT uses for managing this type of architecture: https://{provider_name}.upswot.com/admin/{tenant_alias}
For Sandbox development, use admin
default tenant. The full URL will look like this:
https://sandbox.upswot.com/admin
Production will look like this:
https://app.upswot.com/admin/{tenant_alias}
Request and Response format
upSWOT APIs use the create, read, update, and delete (CRUD) basic operations through POST
, GET
, PUT
, and DELETE
requests and return responses in a standard JSON data format.
Errors
Error handling varies depending on the API or tool you're using. For example, if your request causes an error, the response will contain an error object with information to help you resolve the problem. For Webhooks, if our request to your URL or web application fails for any reason, we'll keep trying.
For details about how our APIs handle errors, see the Errors page.