---
title: "Create partner"
method: POST
path: "/partners"
tags: ["Partners"]
---

# Create partner

`POST /partners`

## Request

- Base URL: `http://localhost/app4legal/api/v2/money`
- URL: `http://localhost/app4legal/api/v2/money/partners`
- Auth: OAuth 2
  - Password
  - Token URL: `http://localhost/app4legal/api/v2/core/login`
- TypeScript: <https://skmtc.dev/app4legal/apis/a4l-money-api/docs/partners/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a partner

## Request body

- object
  - `company_id` integer, nullable: Company id; required when contact_id is not sent
  - `contact_id` integer, nullable: Contact id; required when company_id is not sent
  - `isThirdParty` 'yes' | 'no', nullable

## Response `201`

Successful operation

- object
  - `message` string
  - `partner` object
    - `id` integer
    - `company_id` integer, nullable
    - `contact_id` integer, nullable
    - `isThirdParty` string
    - `type` string
    - `name` string
    - `label` string

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-08-06** `e0d144609998`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/app4legal/apis/a4l-money-api/changes/partners/post.md)

---

[API](https://skmtc.dev/app4legal/apis/a4l-money-api.md) - [All operations](https://skmtc.dev/app4legal/apis/a4l-money-api/llms.txt) - [OpenAPI document](https://skmtc.dev/app4legal/apis/a4l-money-api/revisions/e0d144609998?raw)