---
title: "POST /brokers"
method: POST
path: "/brokers"
tags: ["brokers"]
---

# POST /brokers

`POST /brokers`

Create a new broker

## Request body

- PostBrokers — Create a new broker
  - `email` string
  - `role` 'technical', required — Role of the broker, Only 'technical' brokers can be created for now.
  - `salutation` string
  - `first_name` string
  - `last_name` string
  - `position` string
  - `phone` string
  - `cell` string
  - `partial_custom_fields` unknown

## Response `201`

Create a new broker

- BrokerEntity — BrokerEntity model
  - `id` integer
  - `first_name` string
  - `last_name` string
  - `salutation` string
  - `academic_title` string
  - `avatar_url` string
  - `position` integer
  - `email` string
  - `color` string
  - `locale` string
  - `description` string
  - `cell` string
  - `phone` string
  - `public_cell` string
  - `public_phone` string
  - `team_id` integer
  - `access_team_ids` integer[]
  - `custom_fields` object
  - `role` 'owner' | 'user' | 'free_user' | 'technical' | 'consulting'
  - `archived` boolean
  - `blocked` boolean

## Other responses

- `400` — validation_error
- `401` — authentication_error
- `403` — authorization_error
- `404` — not_found_error
- `422` — validation_error
- `500` — internal_server_error

---

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