GET /v1/groups
GET /v1/groups/:id
POST /v1/groups
PUT /v1/groups/:id
DELETE /v1/groups/:id

A group represents a department, division, or sub-brand within your organisation, and provides an isolated configuration for business identity, contact information, and branding.

Groups are primarily used to assign envelopes to a shared context — allowing accounts within the same group to access and manage each other’s envelopes when they are marked as shared. This makes them ideal for firms with multiple teams, service lines, or branded business units operating under a single organisation.

Each group can override the organisation’s default branding. Group-level settings such as business name, logo, contact number, email, and website will appear in envelope notifications and the signing experience for any envelope sent by an account in that group.

If group contact fields are set, they will replace both the sender account’s and the organisation’s values in all recipient-facing interactions.

Attributes

id
string

The unique identifier for the group.

name
string(250)

The label used to identify the group in the Annature dashboard.

business
string(250)

The business name displayed to recipients, replacing the organisation’s name for envelopes sent from this group.

email
string(250)

The email address displayed to recipients, overriding the sender’s and organisation’s default email.

number
string(100)

The phone number associated with the group. Used in place of the organisation’s contact number.

address
string(250)

The street address associated with the group. Displayed in place of the organisation’s address when shown to recipients.

website
string(250)

The group’s website URL, used in recipient-facing templates and email footers.

The Annature-hosted URL of the group’s logo image. This logo will be displayed on signing pages and email communications for envelopes sent by this group.

color
string

Hex value representing the group’s branding color (e.g., #0044CC). Used for buttons and accents in the recipient UI.

created
string

The ISO 8601 timestamp indicating when the group was created.

GET /v1/groups
GET /v1/groups/:id
POST /v1/groups
PUT /v1/groups/:id
DELETE /v1/groups/:id