Create Group
Creates a new group with associated websites. Requires a global API key. Partner integrations may include an external_id to map their own identifier onto the new Athena group.
Body
Request body for creating a new group
Name of the group.
1"Enterprise Clients"
List of website IDs to include in the group. All websites must belong to your organization.
1Whether to enable billing for this group
false
Partner-only. An identifier from your own system to map to this Athena group. Accepted only when authenticating with an API key for an organization flagged as a partner. Sending this field as a direct customer returns 403 Forbidden. Must be unique per resource type within your organization — duplicates return 409 with the existing resource in the payload.
1"acct_9e4c1b8d"
Response
Group created successfully
A newly created group resource
Present only when billing_enabled was requested: whether the billing entity exists after provisioning. When false, entity creation failed even after a retry, and setting group credits fails with a 400 until billing is repaired via PATCH /api/v1/groups/{group_id} with billing_enabled: true.