---
title: "Adds an Organisation"
method: POST
path: "/Organisations"
tags: ["Organisations"]
---

# Adds an Organisation

`POST /Organisations`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Organisations`
- Auth: none declared. Required headers: `Authorization`

If you have trouble with creating an Organisation, try creating Organisations via the web interface, and then access those Organisations via the API. This way you            can see examples of the fields and sub-elements attached to the Organisation. A common source of problems during write/update request is caused when users omit            required fields, or insert invalid data in a field (e.g. reference a CATEGORY_ID that does not exist in the user's Insightly instance.

## Headers

- `Authorization` string, required

## Request body

- object
  - `ORGANISATION_ID` integer, required
  - `ORGANISATION_NAME` string, string, required
  - `BACKGROUND` string, string
  - `IMAGE_URL` string, string
  - `OWNER_USER_ID` integer
  - `PHONE` string, string
  - `PHONE_FAX` string, string
  - `WEBSITE` string, string
  - `ADDRESS_BILLING_STREET` string, string
  - `ADDRESS_BILLING_CITY` string, string
  - `ADDRESS_BILLING_STATE` string, string
  - `ADDRESS_BILLING_COUNTRY` string, string
  - `ADDRESS_BILLING_POSTCODE` string, string
  - `ADDRESS_SHIP_STREET` string, string
  - `ADDRESS_SHIP_CITY` string, string
  - `ADDRESS_SHIP_STATE` string, string
  - `ADDRESS_SHIP_POSTCODE` string, string
  - `ADDRESS_SHIP_COUNTRY` string, string
  - `SOCIAL_LINKEDIN` string, string
  - `SOCIAL_FACEBOOK` string, string
  - `SOCIAL_TWITTER` string, string
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Response `201`

Request succeeded.

- object
  - `ORGANISATION_ID` integer, required
  - `ORGANISATION_NAME` string, string, required
  - `BACKGROUND` string, string
  - `IMAGE_URL` string, string
  - `OWNER_USER_ID` integer
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `LAST_ACTIVITY_DATE_UTC` string, date-time
  - `NEXT_ACTIVITY_DATE_UTC` string, date-time
  - `CREATED_USER_ID` integer
  - `PHONE` string, string
  - `PHONE_FAX` string, string
  - `WEBSITE` string, string
  - `ADDRESS_BILLING_STREET` string, string
  - `ADDRESS_BILLING_CITY` string, string
  - `ADDRESS_BILLING_STATE` string, string
  - `ADDRESS_BILLING_COUNTRY` string, string
  - `ADDRESS_BILLING_POSTCODE` string, string
  - `ADDRESS_SHIP_STREET` string, string
  - `ADDRESS_SHIP_CITY` string, string
  - `ADDRESS_SHIP_STATE` string, string
  - `ADDRESS_SHIP_POSTCODE` string, string
  - `ADDRESS_SHIP_COUNTRY` string, string
  - `SOCIAL_LINKEDIN` string, string
  - `SOCIAL_FACEBOOK` string, string
  - `SOCIAL_TWITTER` string, string
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object
  - `TAGS` APITag[]
    - `TAG_NAME` string
  - `DATES` APIDate[]
    - `DATE_ID` integer
    - `OCCASION_NAME` string
    - `OCCASION_DATE` string, date-time
    - `REPEAT_YEARLY` boolean
    - `CREATE_TASK_YEARLY` boolean
  - `EMAILDOMAINS` APIEmailDomain[]
    - `EMAIL_DOMAIN_ID` integer
    - `EMAIL_DOMAIN` string, required
  - `LINKS` APILinkDto[]
    - `LINK_ID` integer
    - `OBJECT_NAME` string
    - `OBJECT_ID` integer
    - `LINK_OBJECT_NAME` string
    - `LINK_OBJECT_ID` integer
    - `ROLE` string
    - `DETAILS` string
    - `RELATIONSHIP_ID` integer
    - `IS_FORWARD` boolean

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `402`: Record limit reached.

---

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