---
title: "Add or update a party"
method: POST
path: "/parties"
tags: ["party"]
---

# Add or update a party

`POST /parties`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/parties`
- Auth: HTTP bearer

Adds a person or organization, or updates the existing one with the same legal name and an email in common. Pass source_quote with the text you read the details from.

## Request body

- object
  - `party_id` string
  - `kind` 'individual' | 'entity' | 'joint', required
  - `legal_name` string, required
  - `emails` string[]
  - `roles` string[]
  - `address` object
    - `lines` string[], required
    - `country` string, required: ISO 3166-1 alpha-2
    - `region` string
  - `signatories` object[]
    - `name` string, required
    - `title` string, required
    - `email` string, email, required
  - `member_id` string
  - `source_quote` string

## Response `200`

The result.

- object
  - `id` string, required
  - `kind` 'individual' | 'entity' | 'joint', required
  - `legal_name` string, required
  - `emails` string[], required
  - `roles` string[], required
  - `address` object, nullable, required
    - `lines` string[], required
    - `country` string, required: ISO 3166-1 alpha-2
    - `region` string
  - `signatories` object[], required
    - `name` string, required
    - `title` string, required
    - `email` string, email, required
  - `member_id` string, nullable, required
  - `entered_by_agent` boolean, required
  - `source_quote` string, nullable, required
  - `archived` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)