---
title: "Creates a new Syncro integration for the provider"
method: POST
path: "/providers/{provider_id}/integrations/syncro"
tags: ["Providers"]
---

# Creates a new Syncro integration for the provider

`POST /providers/{provider_id}/integrations/syncro`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/providers/{provider_id}/integrations/syncro`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/providers/:provider_id/integrations/syncro/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new Syncro integration for the provider. You must be associated with the provider to use this route. A 422 Unprocessable Entity response means the server failed to validate with Syncro.

## Request body

- SyncroIntegrationReq: Request for creating a Syncro integration
  - `subdomain` string, required: The subdomain for the URL to connect to Syncro.
  - `apiToken` string, required: The Syncro API token for authentication

## Response `201`

Created

- object
  - `integrationId` string, required: The identifier of the created integration

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity. The server failed to validate credentials with Syncro.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)