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

# Create, edit, and/or delete Autotask Mappings

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

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/integrations/autotask/{UUID}/mappings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/integrations/autotask/: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 Autotask companies/contracts/services. You must be associated to the same provider as the Autotask integration to use this api.

## Request body

- AutotaskMappingRequest: Request object for creating Autotask mappings
  - `data` object[]
    - `organization` AutotaskMappingRequestOrganization, required
      - `id` string, required
      - `name` string, nullable, required
    - `delete` boolean
    - `company` AutotaskMappingRequestCompany, required
      - `id` string, nullable, required
      - `name` string, nullable, required
    - `contract` AutotaskMappingRequestContract, nullable
      - `id` string, nullable
      - `name` string, nullable
    - `service` AutotaskMappingRequestService, nullable
      - `id` string, nullable
      - `name` string, nullable
      - `nonBillableUsers` integer, nullable

## Response `204`

No Content

- AutotaskMappingResponse: Autotask mapping GET response
  - `lastSyncStatus` string, nullable
  - `lastSyncDateTime` string, nullable
  - `organization` AutotaskMappingResponseOrganization
    - `id` string
    - `name` string, nullable
  - `company` AutotaskMappingResponseCompany, nullable
    - `id` string
    - `name` string
  - `contract` AutotaskMappingResponseContract, nullable
    - `id` string
    - `name` string
  - `service` AutotaskMappingResponseService, nullable
    - `id` string
    - `name` string
    - `nonBillableUsers` integer

## 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)