# Create a connector of your own

Source: https://docs.vlayers.ai/reference/hosting/create-workspace-connector

`POST /v1/workspace-connectors` · scope `workspace:write`

Makes a connector named `ws/<workspace>/<name>` and says where its image is pushed (`repository`). Asking again for a name you already made returns the same connector. Push the image there, then publish a version with `POST /v1/workspace-connectors/{name}/versions`.

Requires an API key with the `workspace:write` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `name` | body | string | yes | The connector name: lower-case letters, digits and dashes, starting with a letter (up to 40 characters). |

## Request

cURL:

```bash
curl -X POST https://api.vlayers.ai/v1/workspace-connectors \
  -H "Authorization: Bearer $VOICELAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "telegram"
  }'
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { repository } = await voicelayer.hosting.createWorkspaceConnector({ name: 'telegram' });
console.log(repository);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.create_workspace_connector(name="telegram")
print(result.repository)
```

## Response `201`

```json
{
  "connectorId": "ws/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/telegram",
  "name": "telegram",
  "repository": "registry.vlayers.ai/0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45/0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
  "published": {
    "version": 3,
    "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012",
    "publishedAt": "2026-10-20T15:04:05.000Z"
  },
  "latestVersion": 3,
  "requirements": {
    "handshakeToken": false,
    "primary": true,
    "hosts": [
      "api.telegram.org"
    ]
  }
}
```
