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"
}