# Get Started with Synqly

Get up and running with Synqly in just a few minutes.

In this tutorial, you will:

- Generate an Organization Access Token
- Create a test account
- Create an integration using the Mock Provider
- Make your first Synqly API request


By the end of this guide, you will have a working integration and be able to query data from Synqly APIs.

## Before you begin

Make sure you have:

- Accepted your Synqly organization invitation
- Access to the [Synqly Management Console](https://app.synqly.com/)


## Step 1 - Generate an Organization Access Token

Your Organization Access Token is used to authenticate [Management API](https://docs.synqly.com/api-reference/management) requests.

1. Sign in to the [Synqly Management Console](https://app.synqly.com/)
2. Navigate to **Settings → API Keys**
3. Generate a **Primary Access Token**
4. Store the token securely in your application configuration or `.env` file


For more information, see the [Authentication documentation](https://docs.synqly.com/api-reference/authentication).

Synqly API Keys Page
## Step 2 - Create a Test Account

Create a Test Account that will own your integrations.

Run the following request using the Organization Access Token generated in Step 1.

A successful response returns an account object similar to the following:


```json
{
  "result": {
    "account": {
      "name": "~8a940e4c-1252-4569-bc82-542bb490c8bc",
      "id": "8a940e4c-1252-4569-bc82-542bb490c8bc",
      "fullname": "~8a940e4c-1252-4569-bc82-542bb490c8bc",
      "organization_id": "7f643487-0b9e-4721-92be-ae0470eda8ee",
      "environment": "test",
      "created_at": "2026-05-26T09:51:46.929847Z",
      "updated_at": "2026-05-26T09:51:46.929847Z"
    }
  }
}
```

Save the following value from the response:

- `result.account.id`


You will use this Account ID in the next step.

## Step 3 - Create an Integration using the Mock Provider

To help you get started quickly, Synqly provides [Mock Providers](https://docs.synqly.com/guides/labs/mock-provider-overview) that simulate real product integrations.

Instead of connecting to an actual third-party platform such as CrowdStrike, you can use a mock provider to:

- Create integrations instantly
- Test API requests safely
- Explore connector behavior during development
- Avoid external authentication flows


In this example, you will create an EDR integration using the `edr_crowdstrike_mock` provider.

A successful response returns:

- An Integration ID
- An Integration Access Token


Example response:


```json
{
  "result": {
    "integration": {
      "id": "aa42f9fb-c32b-476d-9975-1099d1ab22e8",
      "account_id": "8a940e4c-1252-4569-bc82-542bb490c8bc",
      "category": "edr",
      "provider_fullname": "[MOCK] CrowdStrike Insight EDR",
      "provider_type": "crowdstrike_mock"
    },
    "token": {
      "access": {
        "secret": "<INTEGRATION_ACCESS_TOKEN>"
      },
      "refresh": {
        "secret": "<REFRESH_TOKEN>"
      }
    }
  }
}
```

Save the following values from the response:

- `result.integration.id`
- `result.token.access.secret`


You will use the Integration Access Token to call [Connector APIs](https://docs.synqly.com/api-reference/connectors).

## Step 4 - Make your first API request

You are now ready to make API requests using your Integration Access Token.

Since this tutorial uses the `edr_crowdstrike_mock` provider, the integration exposes data models related to the [EDR (Endpoint Detection and Response) category](https://docs.synqly.com/api-reference/connectors/edr).

In the following examples, you will query:

- EDR Endpoints
- EDR Applications


These APIs return mock EDR data from the Synqly platform, allowing you to explore the connector experience without connecting to a real CrowdStrike environment.

### Query EDR Endpoints

### Query EDR Applications

You should receive mock CrowdeStrike EDR response data related to endpoints and applications.

## What’s next

Now that you have successfully created your first Synqly integration, you can continue exploring:

- [Synqly SDKs](https://docs.synqly.com/guides/getting-started/sdks)
- [Authentication and Tokens](https://docs.synqly.com/guides/getting-started/authorization)
- [API Reference](https://docs.synqly.com/api-reference/overview)