---
title: "Create client"
method: POST
path: "/api/network/v1/enterprises/{enterpriseId}/clients"
tags: ["Client Activation"]
---

# Create client

`POST /api/network/v1/enterprises/{enterpriseId}/clients`

Create a new OES client for the specified enterprise. This endpoint allows enterprise users
to create a new client within the OES system, establishing the foundation for future trading
activities. The client will be automatically associated with the enterprise specified in the path
parameter.

Error scenarios:
- 400: Invalid Request Error
- Occurs when the request parameters are invalid or incomplete/
- Examples: Empty string supplied for enterpriseId.

- 401: Authentication Error
- Occurs when the request is not authorized.
- Examples: Caller is not a member of the enterprise.

- 403: Permission Denied Error
- Occurs when the user does not have permission to create a client for this enterprise.
- Examples: Enterprise does not have OES license.

- 500: Internal Server Error
- Occurs when there's an unexpected error processing the request.
- Examples: Database connection failure, transient network error.

**Requires access token scopes:** `settlement_network_read`, `settlement_network_write`

## Path parameters

- `enterpriseId` string, required

## Response `200`

OK

- V1ClientsPostOkPayload
  - `client` V1ClientsOutput, required — Output representation of a OES client. Contains all client properties with ISO-formatted date strings for timestamps.
    - `id` string, required — The id of the client.
    - `enterpriseId` string, required — The enterprise ID that this client is associated with.
    - `trustOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1', required
    - `walletId` string, required — The Go Account ID that the client is associated with
    - `createdAt` string, date-time, required — The timestamp when the client was created. (ISO 8601 format)
    - `updatedAt` string, date-time, required — The timestamp when the client was last updated. (ISO 8601 format)
    - `balanceAlertLastSent` string — Last time a balance alert was sent. Typically will be undefined.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)