---
title: "Add connector addon to workspace"
method: POST
path: "/workspaces/{workspace_id}/addons/connectors"
tags: ["Workspaces"]
---

# Add connector addon to workspace

`POST /workspaces/{workspace_id}/addons/connectors`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/addons/connectors`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Add a connector addon to the specified workspace

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.

## Request body

- AddConnectorAddonRequest
  - `connector_id` integer, nullable: ID of the connector to add as an addon (single)
  - `connector_ids` integer[], nullable: IDs of the connectors to add as addons (bulk)

## Response `201`

Connector addon added successfully

- AddonSuccessBulkResponse
  - `status` string, nullable: Request status
  - `addons` AddonResponse[], required: Details of the created addons
    - `id` integer, required: Unique identifier for the addon
    - `workspace_id` integer, required: ID of the workspace this addon belongs to
    - `addon_type` string, required: Type of addon (connector, storage, user)
    - `additional_info` object, required: Additional information related to the addon
    - `status` string, required: Status of the addon (pending, active, cancelled)
    - `created_at` string, date-time, nullable: When the addon was created
  - `message` string, required: Success message

## Other responses

- `400`: Bad Request
- `401`: Authorization error

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)
