---
title: "Post a custom property to a company"
method: POST
path: "/api/v4/f/{firm_id}/companies/{company_id}/custom"
tags: ["Companies"]
---

# Post a custom property to a company

`POST /api/v4/f/{firm_id}/companies/{company_id}/custom`

## Request

- Base URL: `https://live.getsilverfin.com`
- URL: `https://live.getsilverfin.com/api/v4/f/{firm_id}/companies/{company_id}/custom`
- Auth: OAuth 2
  - Authorization code: `https://live.getsilverfin.com/oauth/authorize`
  - Token URL: `https://live.getsilverfin.com/oauth/token` scopes: `administration:write`

Post a custom property to a company. <br>
<b>Required scope(s):</b> `administration:write`

## Path parameters

- `firm_id` integer, required
- `company_id` integer, required

## Headers

- `Accept` string
- `Content-Type` string

## Request body `multipart/form-data`

- object
  - `namespace` string, required
  - `key` string, required
  - `value` string, required: The value can be one of the following types: boolean, double, integer, object, string

## Response `201`

Successful response

---

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