> ## Documentation Index
> Fetch the complete documentation index at: https://docs.annature.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a group

Creates a new group within your organisation.

Groups provide a flexible way to represent business divisions, service lines, or departments — each with its own contact information and branding. When envelopes are sent by an account assigned to a group, the group’s branding and contact details are shown to recipients in place of the organisation's defaults.

This endpoint supports custom logos and colour settings to help create a fully branded recipient experience.

## Parameters

<ParamField path="name" required>
  The display name for the group. This name will appear in the Annature dashboard.
</ParamField>

<ParamField path="business" type="optional">
  The business name used in recipient-facing content. Replaces the organisation's business name when the envelope is sent by a group member.
</ParamField>

<ParamField path="email" type="optional">
  Email address to be shown in place of the account or organisation email.
</ParamField>

<ParamField path="number" type="optional">
  Phone number to appear in recipient communications.
</ParamField>

<ParamField path="address" type="optional">
  Street address displayed to recipients in place of the organisation’s address.
</ParamField>

<ParamField path="website" type="optional">
  Website URL shown in branded templates and email footers.
</ParamField>

<ParamField path="logo" type="optional">
  A base64-encoded logo image.

  The image must decode to a valid `image/jpeg`, `image/png`, or `image/gif`. Maximum size is 5MB.
</ParamField>

<ParamField path="colour" type="optional">
  Hex colour code for the group’s branding.

  Must be a 6-digit code prefixed with `#` (e.g. `#5469d4`).
</ParamField>

<RequestExample>
  ```bash Endpoint theme={null}
  POST /v1/groups
  ```

  ```json Body theme={null}
  {
    "name": "Annature group",
    "business": "Annature",
    "email": "ted@annature.com.au",
    "number": "1300 000 000",
    "address": "3 Clunies Ross Court, Eight Mile Plains, QLD, 4130",
    "website": "www.annature.com.au",
    "colour": "#5469d4",
    "logo": "iVBORw0KGgoAAAANSUhE.."
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "id": "a5a885caee6286a54ad7bbd4ab5400e9",
    "name": "Annature group",
    "business": "Annature",
    "email": "ted@annature.com.au",
    "number": "1300 000 000",
    "address": "3 Clunies Ross Court, Eight Mile Plains, QLD, 4130",
    "website": "www.annature.com.au",
    "colour": "#5469d4",
    "logo": "https://annature..",
    "created": "2019-12-17T05:30:00Z"
  }
  ```
</ResponseExample>