# Create managed organisation

**POST /organisations**

**Partner organisations only.** A Payroll organisation calling this
endpoint receives `405 Method Not Allowed`. An employer-scoped access
token receives `403 Forbidden`.

Creates a managed organisation and records your Partner organisation as
its manager. Use `single_employer` for an organisation that is one
employer, and `multi_employer` for one that runs payroll for several
employers.

Penfold is the source of truth for managed organisations; see
**Managed organisations** above.



## Servers
- https://payroll-api.getpenfold.dev/v4: https://payroll-api.getpenfold.dev/v4 ()


## Authentication methods
- O auth2 client credentials


## Parameters



### Body: application/json (object)

- **display_name** (string)
  The name of the managed organisation, as shown to its users.

- **type** (string)
  The shape of a managed organisation.

  - `single_employer`: the organisation is one employer.
  - `multi_employer`: the organisation runs payroll for several employers,
    for example a payroll bureau.



## Responses
### 201
Managed organisation created

#### Body: application/json (object)
- **id** (string)
  The unique identifier for the managed organisation. Store this; it is the key for every other organisation endpoint.

- **display_name** (string)
  The name of the managed organisation.

- **type** (string)
  The shape of a managed organisation.

  - `single_employer`: the organisation is one employer.
  - `multi_employer`: the organisation runs payroll for several employers,
    for example a payroll bureau.

- **created_at** (string(date-time))
  The date and time the managed organisation was created, in ISO 8601 format.


### 400
Bad request, the request is malformed or contains invalid data.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.

- **validation_errors** (array[object])


### 401
Unauthorized

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 403
Forbidden, the access token is scoped to an employer.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 405
Method not allowed

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.



[Powered by Bump.sh](https://bump.sh)