# Create a circle

**POST /api/v1/circles**




## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **name** (string)
  Circle name
- **bg_colour** (string)
  Hex colour for avatar background
- **account_uuids** (array[string])
  Account UUIDs that are being added to the circle. Between 1 and 100 account UUIDs are required.
- **group_uuids** (array[string])
  Groups UUIDs the circle will belong to. Can belong to a maximum of 50 groups.


## Responses
### 201


#### Body: application/json (object)
- **uuid** (string)
  The UUID of the resource.
- **created_at** (string)
  The timestamp of when the resource was created.
- **updated_at** (string)
  The timestamp of when the resource was updated.
- **name** (string)
  The Circle name
- **photo_url** (string)
  URL for initial avatar image
- **bg_colour** (string)
  Hex colour background for avatar
- **accounts** (array[object])
  Accounts belonging to the circle
- **groups** (array[object])
  Groups the circle belongs to
- **joint_account_uuid** (string)
  uuid of joint account where circle created from joint account
- **login_access_level** (string)
  The access level in context of an account. Note this field is only returned when using the accounts API. Available values: read and write
- **external_references** (array[object])
  The external references that have been added to the client.


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