---
title: "Create, edit, and/or delete Syncro Mappings"
method: PATCH
path: "/api/v2/integrations/syncro/{UUID}/mappings"
tags: ["Providers"]
---

# Create, edit, and/or delete Syncro Mappings

`PATCH /api/v2/integrations/syncro/{UUID}/mappings`

## Request

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

Create, edit, and/or delete mappings between Jumpcloud organizations and Syncro companies. You must be associated to the same provider as the Syncro integration to use this api.

## Request body

- SyncroMappingRequest: Request object for creating Syncro mappings
  - `data` object[]
    - `organization` object, required
      - `id` string, required
      - `name` string, nullable, required
    - `delete` boolean
    - `company` object, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `billingConfigurations` object, nullable: Syncro billing mapping details
      - `fields` object
        - `line_item_name` object
          - `stringValue` string
          - `kind` string
        - `line_item_id` object
          - `numberValue` number
          - `kind` string
        - `schedule_name` object
          - `stringValue` string
          - `kind` string
        - `schedule_id` object
          - `numberValue` number
          - `kind` string

## Response `204`

No Content

- SyncroMappingRequest: Request object for creating Syncro mappings
  - `data` object[]
    - `organization` object, required
      - `id` string, required
      - `name` string, nullable, required
    - `delete` boolean
    - `company` object, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `billingConfigurations` object, nullable: Syncro billing mapping details
      - `fields` object
        - `line_item_name` object
          - `stringValue` string
          - `kind` string
        - `line_item_id` object
          - `numberValue` number
          - `kind` string
        - `schedule_name` object
          - `stringValue` string
          - `kind` string
        - `schedule_id` object
          - `numberValue` number
          - `kind` string

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

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