POST /v1/groups
{
  "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",
  "color": "#5469d4",
  "logo": "https://annature..",
  "created": "2019-12-17T05:30:00Z"
}

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

name
required

The display name for the group. This name will appear in the Annature dashboard.

business
optional

The business name used in recipient-facing content. Replaces the organisation’s business name when the envelope is sent by a group member.

email
optional

Email address to be shown in place of the account or organisation email.

number
optional

Phone number to appear in recipient communications.

address
optional

Street address displayed to recipients in place of the organisation’s address.

website
optional

Website URL shown in branded templates and email footers.

A base64-encoded logo image.

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

color
optional

Hex colour code for the group’s branding.

Must be a 6-digit code prefixed with # (e.g. #5469d4).

POST /v1/groups
{
  "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",
  "color": "#5469d4",
  "logo": "https://annature..",
  "created": "2019-12-17T05:30:00Z"
}