---
title: "Create user connections"
method: POST
path: "/appwise/v2/accounts"
tags: ["UserAccounts"]
---

# Create user connections

`POST /appwise/v2/accounts`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/appwise/v2/accounts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/appwise/v2/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new user connection for Search. A connection (accountName) associates the app (application UUID) and user information (userId, companyId, and handle). The connection is used to, for example, identify events related to the user's app account. accountName Format: {user_handle}@{user_uuid}@{company_uuid}
Note: Application UUID = Product UUID

## Request body

- UserConnection: Defines a user account connection for Search. A connection (accountName) associates the app (application UUID) and user information (userId, companyId, and handle). The connection is used to, for example, identify events related to the user's app account. Format: {user_handle}@{user_uuid}@{company_uuid} Note: Application UUID = Product UUID
  - `app` ApplicationToConnect, required: Identify an application that can be connected to users for Search
    - `id` string, required: Application UUID. Note: Application UUID = Product UUID.
  - `user` UserToConnect, required: Identify a user so they can be connected, with an app user account, to Search
    - `userId` string, required: The user's UUID
    - `companyId` string, required: The user's company's UUID
    - `handle` string, required: The user's handle in the application

## Response `201`

Success

- UserConnectionResponse: Sucessful user account connection response. It provides the details about the connection (accountName): the associated app (application UUID) and user information (userId, companyId, and handle). Format: {user_handle}@{user_uuid}@{company_uuid} Note: Application UUID = Product UUID

## Other responses

- `400`: Input is invalid or malformed
- `401`: Request cannot be authenticated
- `403`: Request is authenticated but does not have permission to access the resource(s)
- `404`: The application and/or user were not found
- `409`: Inputs are valid, but this user and handle are already connected to the service
- `502`: Internal services are unavailable

## Changes

- **2026-11-06** `1fc240f06971`: 10 breaking, 30 info
  - added the new required request property `app`
  - added the new required request property `user`
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `201`
  - …36 more

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/appwise/v2/accounts/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)