FAfactorialhr
Posts > Group

Creates a Group

Changed on

Creates a Group

post/api/2026-10-01/resources/posts/groups

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/posts/groups
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: posts
    • or API key in header x-api-key

Request body

titlestring required

title of the group.

descriptionstring required

description of the group.

company_idstring required

Identifier of the company, this value can be retrieved from core/me endpoint

Example request

{
  "title": "Company announcements",
  "description": "The place to find all company announcements.",
  "company_id": "1"
}

Response

CREATED

idstring required

identifier of the group.

titlestring required

title of the group.

descriptionstring

description of the group.

Example response

{
  "id": "1",
  "title": "Company announcements",
  "description": "The place to find all company announcements."
}

Changes